EvolutionAPI音频发送故障分析与解决方案

问题概述

在使用EvolutionAPI与Chatwoot集成时，用户报告了音频文件发送失败的问题。当尝试通过Chatwoot界面发送音频消息时，系统无法将音频正确传递到即时通讯应用，并在EvolutionAPI日志中显示错误信息。

错误现象分析

从日志中可以观察到以下关键错误信息：

1. 音频转换过程中FFmpeg报错："Failed to read frame size: Could not seek to 1163"
2. 文件参数无效错误："Invalid argument"
3. 在较新版本中还出现了"TypeError: Cannot read properties of undefined (reading '0')"的错误

这些错误表明系统在处理音频文件时遇到了格式转换或文件读取问题。

根本原因

经过分析，问题主要由以下几个因素导致：

1. SSL证书配置不当：EvolutionAPI需要正确的SSL证书配置来处理媒体文件传输，特别是当Chatwoot与EvolutionAPI之间通过HTTPS通信时。

2. 文件上传设置：Chatwoot的DIRECT_UPLOADS_ENABLED参数未正确配置，导致音频文件无法被正确处理。

3. 音频格式转换问题：系统尝试将音频文件从MP3转换为MP4格式时，FFmpeg无法正确处理输入文件。

4. 环境变量缺失：FORCE_SSL设置未启用，影响了安全传输。

解决方案

1. SSL证书配置

确保为EvolutionAPI配置了有效的SSL证书。可以通过以下方式实现：

• 使用Let's Encrypt等免费证书颁发机构获取证书
• 通过Traefik或Nginx配置SSL终止
• 确保证书链完整且未过期

2. Chatwoot环境变量调整

修改Chatwoot的环境变量配置：

FORCE_SSL=true
DIRECT_UPLOADS_ENABLED=true

这些设置将强制使用SSL连接并启用直接文件上传功能。

3. FFmpeg配置检查

验证系统中安装的FFmpeg版本是否兼容：

ffmpeg -version

确保安装的是完整版本，支持常见的音频编解码器。

4. 文件权限设置

检查EvolutionAPI的临时文件存储目录权限：

chmod -R 755 /evolution/store/temp

确保应用程序有权限读写临时文件。

验证步骤

1. 在Chatwoot中尝试发送短音频消息
2. 检查EvolutionAPI日志是否有新的错误
3. 验证即时通讯客户端是否收到音频消息
4. 测试不同格式的音频文件(MP3, OGG等)

预防措施

1. 定期检查SSL证书有效期
2. 监控文件上传服务的可用性
3. 保持FFmpeg等依赖项更新
4. 实施日志监控，及时发现类似问题

总结

EvolutionAPI与Chatwoot集成时的音频发送问题通常与安全配置和文件处理设置相关。通过正确配置SSL证书、调整环境变量和验证文件处理流程，可以解决大多数音频传输问题。建议在部署前全面测试媒体文件传输功能，并建立持续监控机制以确保服务稳定性。