Redash数据源连接测试超时问题分析与解决方案

问题背景

在使用Redash预览版(11.0.0-dev)时，用户通过Docker Compose部署环境后，在Web界面测试MySQL数据源连接时遇到超时问题。虽然通过命令行工具manage.py ds test可以成功测试连接，但Web界面却返回"Unknown error occurred while performing connection test"错误。

环境配置分析

从用户提供的Docker Compose配置可以看出：

1. 使用了Redash预览版镜像
2. 配置了PostgreSQL作为元数据库
3. 使用Redis作为缓存
4. 设置了代理环境变量
5. 日志级别为DEBUG

问题现象

Web界面测试连接时出现30秒超时，日志显示：

WORKER TIMEOUT (pid:159)
method=POST path=/api/data_sources/2/test status=500 duration=28531.34ms

而命令行测试却能成功：

Testing connection to data source: mysql (id=2)
MySQL running query: SELECT 1
Success

根本原因

通过分析日志和用户最终解决方案，可以确定问题原因是：

1. Redash的Web工作进程(worker)默认配置的超时时间不足
2. 在特定网络环境下(如通过代理连接)，数据源连接测试可能需要更长时间
3. 后台服务(scheduler/worker)未正确启动导致异步任务处理能力不足

解决方案

用户通过手动启动scheduler和worker服务解决了问题。这提示我们：

1. 服务完整性检查：确保Redash的所有组件都已正确启动，包括：

   • Web服务器
   • Scheduler服务
   • Worker服务

2. 超时配置调整：对于慢速网络环境，可以适当增加：

   • Worker超时时间
   • 前端AJAX请求超时时间

3. 服务监控：部署后应检查所有关键服务的运行状态

最佳实践建议

1. 生产环境部署：

   • 建议使用稳定版而非预览版
   • 确保所有依赖服务(Redis/PostgreSQL)配置正确
   • 配置适当的资源限制和健康检查

2. 调试技巧：

   • 启用DEBUG日志级别
   • 同时使用Web界面和命令行工具测试
   • 检查各组件日志的时间戳是否同步

3. 性能优化：

   • 对于远程数据源，考虑增加连接池大小
   • 调整Celery worker配置以适应长时间运行任务

总结

Redash作为数据可视化平台，其数据源连接测试功能依赖多个组件的协同工作。当遇到连接测试问题时，应从服务完整性、网络环境和配置参数多方面进行排查。通过确保所有后台服务正常运行并适当调整超时设置，可以有效解决这类连接测试失败的问题。