Evolution API V2.2.0 中Chatwoot历史消息导入的SSL连接问题解析

在使用Evolution API V2.2.0与Chatwoot集成时，开发人员可能会遇到历史消息导入失败的问题，主要错误表现为"Error: The server does not support SSL connections"。本文将深入分析该问题的成因及解决方案。

问题现象

当用户尝试通过Evolution API导入Chatwoot的历史消息时，系统会抛出以下错误信息：

1. 数据库连接SSL不支持错误
2. 用户未找到错误
3. 无法读取未定义属性的映射错误

这些错误通常发生在QR码连接成功后，导致历史消息无法正常导入。

根本原因分析

经过排查，该问题主要由两个因素导致：

1. 数据库连接SSL配置不当：默认情况下，PostgreSQL数据库连接尝试使用SSL，但Chatwoot数据库可能未启用SSL支持。

2. 连接字符串参数缺失：在Evolution API的环境变量配置中，CHATWOOT_IMPORT_DATABASE_CONNECTION_URI缺少关键的SSL模式参数。

解决方案

要解决此问题，需要对数据库连接字符串进行以下修改：

1. 在Evolution API的.env配置文件中，定位到CHATWOOT_IMPORT_DATABASE_CONNECTION_URI参数。

2. 在连接字符串末尾添加?sslmode=disable参数，明确禁用SSL连接。

修改后的连接字符串格式应为：

postgres://用户名:密码@主机:端口/数据库名?sslmode=disable

实施建议

1. 修改配置后，需要重启Evolution API服务使更改生效。

2. 对于生产环境，如果确实需要SSL加密连接，应考虑：

   • 在Chatwoot端正确配置PostgreSQL的SSL支持
   • 使用适当的SSL证书
   • 将sslmode参数设置为"require"或"verify-full"

3. 开发环境可以安全使用sslmode=disable，但生产环境应评估安全需求。

总结

通过正确配置数据库连接字符串的SSL参数，可以解决Evolution API与Chatwoot集成时的历史消息导入问题。这一解决方案不仅简单有效，也体现了在系统集成时对底层连接协议细节的重要性。开发人员在处理类似集成问题时，应当特别注意不同组件间的协议兼容性配置。