Whishper项目前端无响应问题分析与解决方案

问题背景

在使用Whishper项目进行语音转录时，部分用户反馈在完成"新建转录"操作并点击"开始"按钮后，前端界面无任何响应。该问题主要出现在Docker容器化部署环境中，涉及Whishper 3.1.3版本。

环境特征

1. 操作系统：Ubuntu 22.04.3 LTS
2. 部署方式：Docker容器化部署
3. 浏览器兼容性：测试过Arc(Windows/Mac)和Edge(Windows)
4. 服务架构：包含MongoDB、LibreTranslate和Whishper三个核心组件

问题表现

用户在完成以下操作流程时出现问题：

1. 访问前端界面(默认8082端口)
2. 点击"新建转录"
3. 输入URL或上传文件
4. 保持默认参数设置
5. 点击"开始"按钮 预期行为是创建新的转录任务，但实际无任何响应。

根本原因分析

通过排查发现主要存在两个配置问题：

1. 环境变量配置错误：

   • WHISHPER_HOST变量被错误地设置为"http://127.0.0.1:8082"
   • 容器内部网络通信需要使用宿主机的实际IP地址

2. 网络通信问题：

   • 前端无法正确访问后端API接口
   • 容器间网络配置需要确保服务发现正常

解决方案

配置修正方案

1. 修改.env文件中的WHISHPER_HOST变量：

   # 错误配置
   WHISHPER_HOST=http://127.0.0.1:8082
   
   # 正确配置(使用宿主机实际IP)
   WHISHPER_HOST=192.168.x.x
   

2. 确保docker-compose.yml中的相关配置：

   environment:
     PUBLIC_INTERNAL_API_HOST: "http://<实际IP>:80"
     PUBLIC_API_HOST: ${WHISHPER_HOST}
   

验证步骤

1. 检查uploads目录是否为空
2. 通过浏览器开发者工具查看网络请求
3. 确认API端点是否可访问(/api/transcriptions)

技术原理

该问题的本质是容器网络通信配置不当。在Docker环境中：

1. 容器有自己的网络命名空间
2. 127.0.0.1指向容器自身而非宿主机
3. 前端服务需要知道如何访问后端API
4. 环境变量需要在构建时正确注入

最佳实践建议

1. 使用固定IP或主机名而非localhost
2. 保持环境变量命名一致性
3. 部署前验证网络连通性
4. 监控uploads目录变化确认文件上传
5. 定期检查容器日志(docker compose logs)

总结

Whishper项目的前端无响应问题通常源于网络配置错误。通过正确设置环境变量，特别是WHISHPER_HOST参数，可以解决大部分部署问题。建议在容器化部署时特别注意网络配置，确保各服务间能够正常通信。