Wekan Docker容器健康检查问题分析与解决方案

问题背景

在使用Wekan项目管理工具的Docker版本时，部分用户从7.45版本升级到7.46或7.47版本时遇到了容器无法正常启动的问题。具体表现为容器健康检查失败，Docker报告"unhealthy container"错误，错误代码为137。

问题现象

当用户尝试将Wekan从7.45版本升级到较新版本时，容器虽然能够启动，但无法通过健康检查，最终被标记为不健康状态。从日志中可以看到，LDAP后台同步和通知清理任务都按计划进行了调度，但容器仍然无法达到健康状态。

根本原因分析

经过技术团队深入调查，发现问题根源在于自定义的健康检查配置。在Wekan的Docker容器中，健康检查脚本原本通过直接调用node命令来验证应用状态。然而，在7.46及后续版本中，Node.js的安装路径发生了变化，导致健康检查无法找到正确的node可执行文件路径。

解决方案

对于遇到此问题的用户，可以采取以下解决方案：

1. 更新健康检查配置：修改Docker Compose或Swarm配置文件中的健康检查部分，使用新的Node.js路径。

2. 使用默认健康检查：考虑使用Wekan官方提供的默认健康检查配置，而不是自定义实现。

3. 验证路径：在容器内部执行which node命令，确认当前版本中Node.js的实际安装路径。

最佳实践建议

为了避免类似问题，建议Wekan用户：

• 在升级前仔细阅读版本变更说明
• 测试环境先行验证升级过程
• 保持健康检查配置的灵活性，避免硬编码路径
• 考虑使用相对路径或环境变量来指定关键可执行文件位置

总结

Wekan作为开源项目管理工具，其Docker版本在7.46更新中引入了Node.js路径的变化，这影响了自定义健康检查的功能。通过理解问题本质并调整相关配置，用户可以顺利完成版本升级并恢复服务正常运行。这也提醒我们在容器化应用中，对路径依赖要保持警惕，采用更健壮的配置方式。