根治HeyGem.ai TTS服务频繁重启：3步定位+解决方案

根治HeyGem.ai TTS服务频繁重启：3步定位+解决方案

【免费下载链接】HeyGem.ai 项目地址: https://gitcode.com/GitHub_Trending/he/HeyGem.ai

你是否遇到HeyGem.ai的TTS（文本转语音）服务频繁重启，导致语音合成任务中断、用户体验下降？本文将通过分析服务架构、日志系统和配置参数，提供从定位到根治的完整解决方案，帮助开发者和运维人员快速恢复服务稳定性。

问题定位：从代码到配置的3个关键检查点

TTS服务的稳定性依赖于请求处理、资源管理和错误恢复机制的协同工作。通过分析项目核心文件，可快速定位重启原因。

1. TTS API请求处理逻辑

TTS服务的入口在src/main/api/tts.js，核心函数makeAudio负责向TTS服务发送合成请求：

export function makeAudio(param) {
  log.debug('~ makeAudio ~ param:', JSON.stringify(param))
  return request.post(`${serviceUrl.tts}/v1/invoke`, param, {
    responseType: 'arraybuffer'
  })
}

潜在风险：未处理请求超时和服务端错误，当TTS服务响应缓慢或返回异常时，可能导致客户端请求堆积，最终触发进程重启。

2. 服务地址配置检查

服务端地址配置位于src/main/config/config.js，开发环境与生产环境使用不同的TTS服务地址：

export const serviceUrl = {
  tts: isDev ? 'http://192.168.4.204:18180' : 'http://127.0.0.1:18180'
}

常见问题：生产环境误使用开发环境地址（192.168.4.204），导致服务不可达；或本地TTS服务（127.0.0.1:18180）未启动，引发请求失败。

3. 日志系统与监控机制

项目日志配置在src/main/logger.js，默认日志级别为debug，文件大小限制2MB：

log.transports.file.maxSize = 2 * 1024 * 1024 // 2M
log.transports.file.maxFiles = 5

监控缺失：当前仅轮询视频合成任务（src/main/interval/interval.js），未实现TTS服务健康检查：

export function init() {
  // 轮询正在合成的视频
  loopPending()
}

解决方案：从应急恢复到架构优化

针对以上问题，分三个层级实施解决方案，确保TTS服务稳定运行。

1. 应急恢复：快速定位并重启服务

当服务异常时，可通过以下步骤临时恢复：

1. 检查服务状态：确认本地TTS服务是否运行（默认端口18180）
2. 查看错误日志：日志文件路径可通过electron-log配置定位，重点搜索[error]标记
3. 重启应用：通过npm run dev（开发环境）或重启桌面应用（生产环境）

2. 代码优化：添加错误处理与重试机制

修改src/main/api/tts.js，增加请求超时设置和错误重试：

export async function makeAudio(param) {
  log.debug('~ makeAudio ~ param:', JSON.stringify(param))
  try {
    return await request.post(`${serviceUrl.tts}/v1/invoke`, param, {
      responseType: 'arraybuffer',
      timeout: 30000 // 30秒超时
    })
  } catch (error) {
    log.error('TTS请求失败，重试1次:', error.message)
    // 重试1次
    return await request.post(`${serviceUrl.tts}/v1/invoke`, param, {
      responseType: 'arraybuffer',
      timeout: 30000
    })
  }
}

3. 架构优化：实现服务健康检查

在src/main/interval/interval.js中添加TTS服务健康检查：

import { checkTtsHealth } from '../service/voice.js'

export function init() {
  // 轮询正在合成的视频
  loopPending()
  // TTS服务健康检查（每30秒）
  setInterval(checkTtsHealth, 30000)
}

健康检查逻辑（需新增src/main/service/voice.js函数）：

export async function checkTtsHealth() {
  try {
    await request.get(`${serviceUrl.tts}/health`)
    log.info('TTS服务健康')
  } catch (error) {
    log.error('TTS服务异常，尝试重启...')
    // 调用系统命令重启本地TTS服务
    // 实际实现需根据TTS服务部署方式调整
  }
}

效果验证：服务稳定性提升方案

通过以下指标验证优化效果：

注：实际监控界面需结合项目前端实现，可参考src/renderer/src/views/video-edit/preview/PreviewView.vue中的任务状态展示逻辑。

总结与下一步

通过请求容错、配置校验和健康检查的三层优化，可显著降低TTS服务重启概率。建议后续完善：

1. TTS服务进程守护：使用PM2或系统服务管理TTS进程自动重启
2. 资源监控：添加CPU/内存使用监控，避免资源耗尽导致重启
3. 告警机制：异常时通过邮件/钉钉推送告警，及时响应问题

完整方案代码已集成至项目deploy/docker-compose.yml配置中，可通过docker-compose up -d一键部署优化后的服务。收藏本文，随时查阅TTS服务稳定性优化指南！

【免费下载链接】HeyGem.ai 项目地址: https://gitcode.com/GitHub_Trending/he/HeyGem.ai