TestSigma社区版自定义域名配置导致截图加载失败问题解析

TestSigma社区版自定义域名配置导致截图加载失败问题解析

问题现象

在使用TestSigma社区版(v3.0.1)进行Web页面用户体验测试时，测试计划执行完成后，在查看结果时发现所有步骤的截图区域都显示"Failed to load the image"错误提示。尽管测试运行本身是成功的，且文件存储中确实生成了对应的JPEG截图文件，但界面无法正常加载这些图片。

环境配置

该问题出现在基于Docker部署的TestSigma社区版环境中，具体配置如下：

• 操作系统：Ubuntu 22.04
• 部署方式：Docker容器化部署
• 版本：TestSigma Community Edition v3.0.1
• 数据库：MySQL 5.7

问题排查

通过检查发现，虽然截图文件确实生成并存储在文件系统中，但前端界面无法正确加载这些资源。进一步排查发现，该问题与自定义域名配置有关。

解决方案

问题的根本原因是使用了自定义域名但没有正确配置环境变量。在Docker Compose配置文件中添加以下环境变量后，问题得到解决：

environment:
  - TESTSIGMA_SERVER_URL=https://自定义域名.com

技术原理

TestSigma社区版在生成截图URL时，会基于配置的服务器地址构建完整的资源路径。当使用自定义域名但未正确配置时，系统无法正确解析资源路径，导致前端加载失败。通过设置TESTSIGMA_SERVER_URL环境变量，系统能够正确识别资源位置，从而解决截图加载问题。

实施建议

对于使用TestSigma社区版并需要配置自定义域名的用户，建议：

1. 在Docker Compose配置中明确设置TESTSIGMA_SERVER_URL环境变量
2. 确保该URL与实际的访问地址完全一致（包括协议头https/http）
3. 部署后验证截图加载功能是否正常

总结

TestSigma社区版作为开源测试自动化工具，在自定义部署场景下需要注意正确的环境变量配置。通过合理配置TESTSIGMA_SERVER_URL，不仅可以解决截图加载问题，还能确保其他依赖服务器地址的功能正常工作。这体现了在容器化部署中环境变量配置的重要性，特别是在涉及资源路径解析的场景下。