1. 为什么选择Spring Boot集成文本转语音服务在当今的互联网应用中语音交互正变得越来越重要。作为一名Java开发者我最近在项目中遇到了需要将文本内容转换为语音的需求。经过多方调研和对比最终选择了MiniMax和CosyVoice这两个服务进行集成。这里分享一下我的完整实现过程和踩坑经验。Spring Boot作为Java生态中最流行的微服务框架其自动配置和快速启动的特性非常适合集成第三方API服务。而MiniMax和CosyVoice作为国内优质的文本转语音(TTS)服务提供商提供了高质量的语音合成能力和相对友好的API接口。提示选择MiniMax和CosyVoice的主要原因是它们对中文语音的支持非常优秀且提供了多种音色选择适合不同场景的语音输出需求。在实际项目中我们可能需要根据不同的业务场景选择不同的语音服务。比如客服场景需要亲切自然的语音教育场景需要清晰标准的发音娱乐场景可能需要更有特色的音色MiniMax和CosyVoice都能很好地满足这些需求而且它们的API响应速度都很快延迟通常在500ms以内这对于实时性要求较高的应用场景非常重要。2. 环境准备与基础配置2.1 创建Spring Boot项目首先我们需要创建一个基础的Spring Boot项目。我推荐使用Spring Initializrhttps://start.spring.io/来快速生成项目骨架。选择以下依赖Spring Web (用于构建RESTful API)Lombok (简化代码)Spring Boot DevTools (开发热部署)# 使用curl快速创建项目 curl https://start.spring.io/starter.zip \ -d dependenciesweb,lombok,devtools \ -d languagejava \ -d typegradle-project \ -d javaVersion17 \ -d groupIdcom.example \ -d artifactIdtts-demo \ -o tts-demo.zip解压后项目结构应该如下tts-demo/ ├── src/ │ ├── main/ │ │ ├── java/com/example/ttsdemo/ │ │ └── resources/ │ └── test/ ├── build.gradle └── settings.gradle2.2 配置API密钥MiniMax和CosyVoice都需要API密钥才能调用它们的服务。这些密钥通常可以在它们的开发者控制台获取。为了安全起见我们应该将这些敏感信息放在配置文件中而不是硬编码在代码里。在application.properties中添加# MiniMax配置 minimax.api.keyyour-minimax-api-key minimax.api.urlhttps://api.minimax.com/v1/tts # CosyVoice配置 cosyvoice.api.keyyour-cosyvoice-api-key cosyvoice.api.urlhttps://api.cosyvoice.com/tts然后创建对应的配置类Configuration ConfigurationProperties(prefix minimax) Data public class MiniMaxConfig { private String apiKey; private String apiUrl; } Configuration ConfigurationProperties(prefix cosyvoice) Data public class CosyVoiceConfig { private String apiKey; private String apiUrl; }注意在实际生产环境中建议使用Spring Cloud Config或Vault等工具来管理这些敏感配置而不是直接放在配置文件中。3. 实现MiniMax文本转语音集成3.1 理解MiniMax APIMiniMax的文本转语音API非常简洁主要需要以下参数text: 要转换的文本内容voice_id: 选择的音色IDspeed: 语速(0.5-2.0)volume: 音量(0-1)audio_format: 输出格式(mp3/wav等)API响应会返回音频文件的二进制流或URL我们可以根据需求选择。3.2 创建MiniMax客户端首先我们创建一个服务类来处理与MiniMax API的交互Service RequiredArgsConstructor public class MiniMaxTtsService { private final MiniMaxConfig config; private final RestTemplate restTemplate; public byte[] convertTextToSpeech(String text, String voiceId, float speed, float volume, String format) { HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.set(Authorization, Bearer config.getApiKey()); MapString, Object requestBody new HashMap(); requestBody.put(text, text); requestBody.put(voice_id, voiceId); requestBody.put(speed, speed); requestBody.put(volume, volume); requestBody.put(audio_format, format); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntitybyte[] response restTemplate.exchange( config.getApiUrl(), HttpMethod.POST, entity, byte[].class); return response.getBody(); } }3.3 创建REST控制器接下来我们创建一个控制器来暴露API给前端或其他服务调用RestController RequestMapping(/api/tts) RequiredArgsConstructor public class TtsController { private final MiniMaxTtsService miniMaxTtsService; PostMapping(/minimax) public ResponseEntitybyte[] convertWithMiniMax( RequestBody TtsRequest request) { byte[] audioData miniMaxTtsService.convertTextToSpeech( request.getText(), request.getVoiceId(), request.getSpeed(), request.getVolume(), request.getFormat()); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.parseMediaType(audio/ request.getFormat())); headers.setContentLength(audioData.length); headers.set(Content-Disposition, attachment; filename\output. request.getFormat() \); return new ResponseEntity(audioData, headers, HttpStatus.OK); } } Data class TtsRequest { private String text; private String voiceId default; private float speed 1.0f; private float volume 1.0f; private String format mp3; }3.4 测试MiniMax集成我们可以使用Postman或curl来测试这个APIcurl -X POST http://localhost:8080/api/tts/minimax \ -H Content-Type: application/json \ -d { text: 欢迎使用MiniMax文本转语音服务, voiceId: female-1, speed: 1.2, volume: 0.9, format: mp3 } \ --output output.mp3如果一切正常你应该会得到一个名为output.mp3的音频文件播放它就能听到转换后的语音。4. 实现CosyVoice文本转语音集成4.1 理解CosyVoice APICosyVoice的API与MiniMax类似但有一些不同的参数content: 要转换的文本speaker: 说话人IDemotion: 情感模式(neutral, happy, angry等)speed: 语速(50-200)pitch: 音高(50-200)format: 音频格式4.2 创建CosyVoice客户端Service RequiredArgsConstructor public class CosyVoiceTtsService { private final CosyVoiceConfig config; private final RestTemplate restTemplate; public byte[] convertTextToSpeech(String text, String speaker, String emotion, int speed, int pitch, String format) { HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.set(X-API-KEY, config.getApiKey()); MapString, Object requestBody new HashMap(); requestBody.put(content, text); requestBody.put(speaker, speaker); requestBody.put(emotion, emotion); requestBody.put(speed, speed); requestBody.put(pitch, pitch); requestBody.put(format, format); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntitybyte[] response restTemplate.exchange( config.getApiUrl(), HttpMethod.POST, entity, byte[].class); return response.getBody(); } }4.3 扩展REST控制器在之前的TtsController中添加CosyVoice的支持RestController RequestMapping(/api/tts) RequiredArgsConstructor public class TtsController { private final MiniMaxTtsService miniMaxTtsService; private final CosyVoiceTtsService cosyVoiceTtsService; // 之前的MiniMax方法... PostMapping(/cosyvoice) public ResponseEntitybyte[] convertWithCosyVoice( RequestBody CosyVoiceRequest request) { byte[] audioData cosyVoiceTtsService.convertTextToSpeech( request.getContent(), request.getSpeaker(), request.getEmotion(), request.getSpeed(), request.getPitch(), request.getFormat()); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.parseMediaType(audio/ request.getFormat())); headers.setContentLength(audioData.length); headers.set(Content-Disposition, attachment; filename\output. request.getFormat() \); return new ResponseEntity(audioData, headers, HttpStatus.OK); } } Data class CosyVoiceRequest { private String content; private String speaker default; private String emotion neutral; private int speed 100; private int pitch 100; private String format mp3; }4.4 测试CosyVoice集成同样使用curl测试curl -X POST http://localhost:8080/api/tts/cosyvoice \ -H Content-Type: application/json \ -d { content: 这是CosyVoice文本转语音服务的测试, speaker: female-joyful, emotion: happy, speed: 120, pitch: 110, format: mp3 } \ --output output_cosy.mp35. 高级功能与优化5.1 实现服务自动切换在实际应用中我们可能希望根据不同的条件自动选择使用MiniMax还是CosyVoice。我们可以创建一个策略模式的服务public interface TtsService { byte[] convertTextToSpeech(TtsRequest request); } Service Primary public class SmartTtsService implements TtsService { private final MiniMaxTtsService miniMax; private final CosyVoiceTtsService cosyVoice; Override public byte[] convertTextToSpeech(TtsRequest request) { // 根据文本长度、语言或其他条件选择服务 if (request.getText().length() 500) { return cosyVoice.convertTextToSpeech(...); } else { return miniMax.convertTextToSpeech(...); } } }5.2 添加缓存机制频繁转换相同的文本会浪费API调用次数我们可以添加缓存Service public class CachedTtsService implements TtsService { private final TtsService delegate; private final CacheManager cacheManager; Override Cacheable(value ttsCache, key #request.text.concat(#request.voiceId)) public byte[] convertTextToSpeech(TtsRequest request) { return delegate.convertTextToSpeech(request); } }需要在配置类上添加EnableCaching注解并配置缓存实现如Redis或Caffeine。5.3 异步处理与WebSocket支持对于长文本转换我们可以使用异步处理并通过WebSocket返回结果RestController RequestMapping(/api/async-tts) public class AsyncTtsController { private final TtsService ttsService; private final SimpMessagingTemplate messagingTemplate; PostMapping public ResponseEntityString convertAsync( RequestBody TtsRequest request, RequestParam String sessionId) { CompletableFuture.runAsync(() - { byte[] audioData ttsService.convertTextToSpeech(request); messagingTemplate.convertAndSend(/topic/tts/ sessionId, audioData); }); return ResponseEntity.accepted().body(Processing started); } }前端可以订阅对应的WebSocket主题来接收结果。6. 常见问题与解决方案6.1 API调用限制处理MiniMax和CosyVoice都有API调用限制。我们可以使用Resilience4j来实现限流和重试Configuration public class ResilienceConfig { Bean public CircuitBreaker miniMaxCircuitBreaker() { return CircuitBreaker.ofDefaults(minimax); } Bean public Retry miniMaxRetry() { return Retry.of(minimax, RetryConfig.custom() .maxAttempts(3) .waitDuration(Duration.ofMillis(500)) .build()); } } Service public class ResilientMiniMaxTtsService { private final MiniMaxTtsService delegate; private final CircuitBreaker circuitBreaker; private final Retry retry; public byte[] convertTextToSpeech(String text, String voiceId, float speed, float volume, String format) { return circuitBreaker.executeSupplier( () - retry.executeSupplier( () - delegate.convertTextToSpeech(text, voiceId, speed, volume, format) ) ); } }6.2 音频质量优化有时生成的音频质量可能不理想可以尝试以下优化分段处理长文本每段300-500字添加适当的标点符号帮助TTS引擎理解断句调整语速和音高参数找到最佳组合对特殊词汇添加发音注解如重(chong2)新6.3 错误处理最佳实践完善的错误处理能提升用户体验RestControllerAdvice public class TtsExceptionHandler { ExceptionHandler(RestClientException.class) public ResponseEntityErrorResponse handleApiError(RestClientException e) { ErrorResponse response new ErrorResponse( TTS_SERVICE_ERROR, Text-to-speech service unavailable: e.getMessage()); return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE).body(response); } ExceptionHandler(IllegalArgumentException.class) public ResponseEntityErrorResponse handleBadRequest(IllegalArgumentException e) { ErrorResponse response new ErrorResponse( INVALID_REQUEST, e.getMessage()); return ResponseEntity.badRequest().body(response); } } Data AllArgsConstructor class ErrorResponse { private String code; private String message; }7. 部署与监控7.1 Docker化部署创建DockerfileFROM eclipse-temurin:17-jdk-jammy WORKDIR /app COPY build/libs/*.jar app.jar ENTRYPOINT [java, -jar, app.jar]构建并运行./gradlew build docker build -t tts-service . docker run -p 8080:8080 tts-service7.2 添加健康检查我们可以添加健康检查端点来监控TTS服务的可用性RestController RequestMapping(/actuator) public class HealthController { private final MiniMaxTtsService miniMax; private final CosyVoiceTtsService cosyVoice; GetMapping(/health/tts) public ResponseEntityMapString, String checkTtsHealth() { MapString, String status new HashMap(); try { miniMax.convertTextToSpeech(test, default, 1.0f, 1.0f, mp3); status.put(minimax, UP); } catch (Exception e) { status.put(minimax, DOWN); } try { cosyVoice.convertTextToSpeech(test, default, neutral, 100, 100, mp3); status.put(cosyvoice, UP); } catch (Exception e) { status.put(cosyvoice, DOWN); } return ResponseEntity.ok(status); } }7.3 性能监控使用Micrometer添加性能指标Configuration public class MetricsConfig { Bean public TimedAspect timedAspect(MeterRegistry registry) { return new TimedAspect(registry); } } Service public class MonitoredTtsService implements TtsService { private final TtsService delegate; private final MeterRegistry registry; Override Timed(value tts.convert.time, description Time taken to convert text to speech) public byte[] convertTextToSpeech(TtsRequest request) { registry.counter(tts.requests, service, delegate.getClass().getSimpleName()).increment(); long start System.currentTimeMillis(); byte[] result delegate.convertTextToSpeech(request); long duration System.currentTimeMillis() - start; registry.summary(tts.convert.duration).record(duration); return result; } }这些指标可以导出到Prometheus或通过Actuator端点查看。 Spring Boot集成MiniMax与CosyVoice实现文本转语音
1. 为什么选择Spring Boot集成文本转语音服务在当今的互联网应用中语音交互正变得越来越重要。作为一名Java开发者我最近在项目中遇到了需要将文本内容转换为语音的需求。经过多方调研和对比最终选择了MiniMax和CosyVoice这两个服务进行集成。这里分享一下我的完整实现过程和踩坑经验。Spring Boot作为Java生态中最流行的微服务框架其自动配置和快速启动的特性非常适合集成第三方API服务。而MiniMax和CosyVoice作为国内优质的文本转语音(TTS)服务提供商提供了高质量的语音合成能力和相对友好的API接口。提示选择MiniMax和CosyVoice的主要原因是它们对中文语音的支持非常优秀且提供了多种音色选择适合不同场景的语音输出需求。在实际项目中我们可能需要根据不同的业务场景选择不同的语音服务。比如客服场景需要亲切自然的语音教育场景需要清晰标准的发音娱乐场景可能需要更有特色的音色MiniMax和CosyVoice都能很好地满足这些需求而且它们的API响应速度都很快延迟通常在500ms以内这对于实时性要求较高的应用场景非常重要。2. 环境准备与基础配置2.1 创建Spring Boot项目首先我们需要创建一个基础的Spring Boot项目。我推荐使用Spring Initializrhttps://start.spring.io/来快速生成项目骨架。选择以下依赖Spring Web (用于构建RESTful API)Lombok (简化代码)Spring Boot DevTools (开发热部署)# 使用curl快速创建项目 curl https://start.spring.io/starter.zip \ -d dependenciesweb,lombok,devtools \ -d languagejava \ -d typegradle-project \ -d javaVersion17 \ -d groupIdcom.example \ -d artifactIdtts-demo \ -o tts-demo.zip解压后项目结构应该如下tts-demo/ ├── src/ │ ├── main/ │ │ ├── java/com/example/ttsdemo/ │ │ └── resources/ │ └── test/ ├── build.gradle └── settings.gradle2.2 配置API密钥MiniMax和CosyVoice都需要API密钥才能调用它们的服务。这些密钥通常可以在它们的开发者控制台获取。为了安全起见我们应该将这些敏感信息放在配置文件中而不是硬编码在代码里。在application.properties中添加# MiniMax配置 minimax.api.keyyour-minimax-api-key minimax.api.urlhttps://api.minimax.com/v1/tts # CosyVoice配置 cosyvoice.api.keyyour-cosyvoice-api-key cosyvoice.api.urlhttps://api.cosyvoice.com/tts然后创建对应的配置类Configuration ConfigurationProperties(prefix minimax) Data public class MiniMaxConfig { private String apiKey; private String apiUrl; } Configuration ConfigurationProperties(prefix cosyvoice) Data public class CosyVoiceConfig { private String apiKey; private String apiUrl; }注意在实际生产环境中建议使用Spring Cloud Config或Vault等工具来管理这些敏感配置而不是直接放在配置文件中。3. 实现MiniMax文本转语音集成3.1 理解MiniMax APIMiniMax的文本转语音API非常简洁主要需要以下参数text: 要转换的文本内容voice_id: 选择的音色IDspeed: 语速(0.5-2.0)volume: 音量(0-1)audio_format: 输出格式(mp3/wav等)API响应会返回音频文件的二进制流或URL我们可以根据需求选择。3.2 创建MiniMax客户端首先我们创建一个服务类来处理与MiniMax API的交互Service RequiredArgsConstructor public class MiniMaxTtsService { private final MiniMaxConfig config; private final RestTemplate restTemplate; public byte[] convertTextToSpeech(String text, String voiceId, float speed, float volume, String format) { HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.set(Authorization, Bearer config.getApiKey()); MapString, Object requestBody new HashMap(); requestBody.put(text, text); requestBody.put(voice_id, voiceId); requestBody.put(speed, speed); requestBody.put(volume, volume); requestBody.put(audio_format, format); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntitybyte[] response restTemplate.exchange( config.getApiUrl(), HttpMethod.POST, entity, byte[].class); return response.getBody(); } }3.3 创建REST控制器接下来我们创建一个控制器来暴露API给前端或其他服务调用RestController RequestMapping(/api/tts) RequiredArgsConstructor public class TtsController { private final MiniMaxTtsService miniMaxTtsService; PostMapping(/minimax) public ResponseEntitybyte[] convertWithMiniMax( RequestBody TtsRequest request) { byte[] audioData miniMaxTtsService.convertTextToSpeech( request.getText(), request.getVoiceId(), request.getSpeed(), request.getVolume(), request.getFormat()); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.parseMediaType(audio/ request.getFormat())); headers.setContentLength(audioData.length); headers.set(Content-Disposition, attachment; filename\output. request.getFormat() \); return new ResponseEntity(audioData, headers, HttpStatus.OK); } } Data class TtsRequest { private String text; private String voiceId default; private float speed 1.0f; private float volume 1.0f; private String format mp3; }3.4 测试MiniMax集成我们可以使用Postman或curl来测试这个APIcurl -X POST http://localhost:8080/api/tts/minimax \ -H Content-Type: application/json \ -d { text: 欢迎使用MiniMax文本转语音服务, voiceId: female-1, speed: 1.2, volume: 0.9, format: mp3 } \ --output output.mp3如果一切正常你应该会得到一个名为output.mp3的音频文件播放它就能听到转换后的语音。4. 实现CosyVoice文本转语音集成4.1 理解CosyVoice APICosyVoice的API与MiniMax类似但有一些不同的参数content: 要转换的文本speaker: 说话人IDemotion: 情感模式(neutral, happy, angry等)speed: 语速(50-200)pitch: 音高(50-200)format: 音频格式4.2 创建CosyVoice客户端Service RequiredArgsConstructor public class CosyVoiceTtsService { private final CosyVoiceConfig config; private final RestTemplate restTemplate; public byte[] convertTextToSpeech(String text, String speaker, String emotion, int speed, int pitch, String format) { HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.set(X-API-KEY, config.getApiKey()); MapString, Object requestBody new HashMap(); requestBody.put(content, text); requestBody.put(speaker, speaker); requestBody.put(emotion, emotion); requestBody.put(speed, speed); requestBody.put(pitch, pitch); requestBody.put(format, format); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntitybyte[] response restTemplate.exchange( config.getApiUrl(), HttpMethod.POST, entity, byte[].class); return response.getBody(); } }4.3 扩展REST控制器在之前的TtsController中添加CosyVoice的支持RestController RequestMapping(/api/tts) RequiredArgsConstructor public class TtsController { private final MiniMaxTtsService miniMaxTtsService; private final CosyVoiceTtsService cosyVoiceTtsService; // 之前的MiniMax方法... PostMapping(/cosyvoice) public ResponseEntitybyte[] convertWithCosyVoice( RequestBody CosyVoiceRequest request) { byte[] audioData cosyVoiceTtsService.convertTextToSpeech( request.getContent(), request.getSpeaker(), request.getEmotion(), request.getSpeed(), request.getPitch(), request.getFormat()); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.parseMediaType(audio/ request.getFormat())); headers.setContentLength(audioData.length); headers.set(Content-Disposition, attachment; filename\output. request.getFormat() \); return new ResponseEntity(audioData, headers, HttpStatus.OK); } } Data class CosyVoiceRequest { private String content; private String speaker default; private String emotion neutral; private int speed 100; private int pitch 100; private String format mp3; }4.4 测试CosyVoice集成同样使用curl测试curl -X POST http://localhost:8080/api/tts/cosyvoice \ -H Content-Type: application/json \ -d { content: 这是CosyVoice文本转语音服务的测试, speaker: female-joyful, emotion: happy, speed: 120, pitch: 110, format: mp3 } \ --output output_cosy.mp35. 高级功能与优化5.1 实现服务自动切换在实际应用中我们可能希望根据不同的条件自动选择使用MiniMax还是CosyVoice。我们可以创建一个策略模式的服务public interface TtsService { byte[] convertTextToSpeech(TtsRequest request); } Service Primary public class SmartTtsService implements TtsService { private final MiniMaxTtsService miniMax; private final CosyVoiceTtsService cosyVoice; Override public byte[] convertTextToSpeech(TtsRequest request) { // 根据文本长度、语言或其他条件选择服务 if (request.getText().length() 500) { return cosyVoice.convertTextToSpeech(...); } else { return miniMax.convertTextToSpeech(...); } } }5.2 添加缓存机制频繁转换相同的文本会浪费API调用次数我们可以添加缓存Service public class CachedTtsService implements TtsService { private final TtsService delegate; private final CacheManager cacheManager; Override Cacheable(value ttsCache, key #request.text.concat(#request.voiceId)) public byte[] convertTextToSpeech(TtsRequest request) { return delegate.convertTextToSpeech(request); } }需要在配置类上添加EnableCaching注解并配置缓存实现如Redis或Caffeine。5.3 异步处理与WebSocket支持对于长文本转换我们可以使用异步处理并通过WebSocket返回结果RestController RequestMapping(/api/async-tts) public class AsyncTtsController { private final TtsService ttsService; private final SimpMessagingTemplate messagingTemplate; PostMapping public ResponseEntityString convertAsync( RequestBody TtsRequest request, RequestParam String sessionId) { CompletableFuture.runAsync(() - { byte[] audioData ttsService.convertTextToSpeech(request); messagingTemplate.convertAndSend(/topic/tts/ sessionId, audioData); }); return ResponseEntity.accepted().body(Processing started); } }前端可以订阅对应的WebSocket主题来接收结果。6. 常见问题与解决方案6.1 API调用限制处理MiniMax和CosyVoice都有API调用限制。我们可以使用Resilience4j来实现限流和重试Configuration public class ResilienceConfig { Bean public CircuitBreaker miniMaxCircuitBreaker() { return CircuitBreaker.ofDefaults(minimax); } Bean public Retry miniMaxRetry() { return Retry.of(minimax, RetryConfig.custom() .maxAttempts(3) .waitDuration(Duration.ofMillis(500)) .build()); } } Service public class ResilientMiniMaxTtsService { private final MiniMaxTtsService delegate; private final CircuitBreaker circuitBreaker; private final Retry retry; public byte[] convertTextToSpeech(String text, String voiceId, float speed, float volume, String format) { return circuitBreaker.executeSupplier( () - retry.executeSupplier( () - delegate.convertTextToSpeech(text, voiceId, speed, volume, format) ) ); } }6.2 音频质量优化有时生成的音频质量可能不理想可以尝试以下优化分段处理长文本每段300-500字添加适当的标点符号帮助TTS引擎理解断句调整语速和音高参数找到最佳组合对特殊词汇添加发音注解如重(chong2)新6.3 错误处理最佳实践完善的错误处理能提升用户体验RestControllerAdvice public class TtsExceptionHandler { ExceptionHandler(RestClientException.class) public ResponseEntityErrorResponse handleApiError(RestClientException e) { ErrorResponse response new ErrorResponse( TTS_SERVICE_ERROR, Text-to-speech service unavailable: e.getMessage()); return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE).body(response); } ExceptionHandler(IllegalArgumentException.class) public ResponseEntityErrorResponse handleBadRequest(IllegalArgumentException e) { ErrorResponse response new ErrorResponse( INVALID_REQUEST, e.getMessage()); return ResponseEntity.badRequest().body(response); } } Data AllArgsConstructor class ErrorResponse { private String code; private String message; }7. 部署与监控7.1 Docker化部署创建DockerfileFROM eclipse-temurin:17-jdk-jammy WORKDIR /app COPY build/libs/*.jar app.jar ENTRYPOINT [java, -jar, app.jar]构建并运行./gradlew build docker build -t tts-service . docker run -p 8080:8080 tts-service7.2 添加健康检查我们可以添加健康检查端点来监控TTS服务的可用性RestController RequestMapping(/actuator) public class HealthController { private final MiniMaxTtsService miniMax; private final CosyVoiceTtsService cosyVoice; GetMapping(/health/tts) public ResponseEntityMapString, String checkTtsHealth() { MapString, String status new HashMap(); try { miniMax.convertTextToSpeech(test, default, 1.0f, 1.0f, mp3); status.put(minimax, UP); } catch (Exception e) { status.put(minimax, DOWN); } try { cosyVoice.convertTextToSpeech(test, default, neutral, 100, 100, mp3); status.put(cosyvoice, UP); } catch (Exception e) { status.put(cosyvoice, DOWN); } return ResponseEntity.ok(status); } }7.3 性能监控使用Micrometer添加性能指标Configuration public class MetricsConfig { Bean public TimedAspect timedAspect(MeterRegistry registry) { return new TimedAspect(registry); } } Service public class MonitoredTtsService implements TtsService { private final TtsService delegate; private final MeterRegistry registry; Override Timed(value tts.convert.time, description Time taken to convert text to speech) public byte[] convertTextToSpeech(TtsRequest request) { registry.counter(tts.requests, service, delegate.getClass().getSimpleName()).increment(); long start System.currentTimeMillis(); byte[] result delegate.convertTextToSpeech(request); long duration System.currentTimeMillis() - start; registry.summary(tts.convert.duration).record(duration); return result; } }这些指标可以导出到Prometheus或通过Actuator端点查看。