认知服务语音SDK在Amazon Linux 2023上的OpenSSL问题解析

问题背景

在使用Azure认知服务语音SDK（C++版本）开发Zoom会议机器人时，开发者遇到了OpenSSL相关的错误。错误日志显示在尝试建立WebSocket连接时出现了SSL错误（error:14200010:SSL routines:func(512):EC lib），随后程序在调用StartContinuousRecognitionAsync()后发生段错误。

环境兼容性分析

Amazon Linux 2023目前并非官方支持的Linux发行版。然而，经过测试验证，在Amazon Linux 2023 Docker镜像中，通过以下配置可以使语音SDK正常工作：

1. 更新系统并安装基础依赖
2. 安装开发工具组
3. 使用最新版语音SDK（1.40.0及以上）
4. 保持系统默认的OpenSSL版本，不进行额外安装或配置

关键发现

自语音SDK 1.38.0版本起，所有发布包都包含两个新的库文件，这对OpenSSL版本检测至关重要：

1. libpal_azure_c_shared.so
2. libpal_azure_c_shared_openssl3.so

这些库文件必须与SDK的其他库文件位于同一目录中。如果项目配置将这些库文件复制到自定义位置，必须确保这两个库文件也被正确复制，否则会导致运行时错误。

解决方案建议

1. 环境配置：确保系统环境干净，使用默认的OpenSSL版本，避免手动安装或配置其他OpenSSL版本。

2. 库文件完整性：检查项目中所有必需的SDK库文件是否完整且位于同一目录下，特别是上述两个新增的libpal库文件。

3. 版本更新：使用最新版本的语音SDK（1.40.0或更高），以获得最佳兼容性和稳定性。

4. 错误诊断：如果问题仍然存在，建议收集完整的错误日志和系统环境信息，包括详细的SDK版本、系统版本和配置信息，以便进一步分析。

总结

虽然Amazon Linux 2023不是官方支持的平台，但通过正确的配置和版本选择，仍然可以在此环境中成功运行认知服务语音SDK。关键在于保持环境的纯净性，确保所有必需的库文件完整且配置正确。对于开发者而言，遵循这些最佳实践可以避免大多数与OpenSSL相关的兼容性问题。