Semaphore项目MySQL非标准端口连接问题分析与修复

问题背景

Semaphore是一个基于Go语言开发的开源Ansible Web UI工具，在v2.10.33版本中引入了一个影响MySQL数据库连接的严重问题。当用户配置MySQL使用非标准端口(非3306)时，系统会忽略配置的端口号，仍然尝试使用默认的3306端口连接数据库。

问题现象

在Docker环境中部署Semaphore时，如果MySQL服务器运行在自定义端口(如3307)，通过环境变量配置：

SEMAPHORE_DB_HOST: <fqdn>
SEMAPHORE_DB_PORT: 3307

生成的配置文件虽然正确显示了端口号：

"mysql": {
    "host": "<fqdn>:3307",
    "user": "<user>",
    "pass": "<password>",
    "name": "<dbname>",
    "options": null
}

但实际连接时系统会错误地尝试使用3306端口，导致连接失败并抛出异常：

panic: dial tcp 192.168.17.21:3306: connect: connection refused

技术分析

这个问题出现在v2.10.33版本中，而在之前的v2.10.32版本中工作正常。从错误日志和代码行为分析，可以推断：

1. 配置解析阶段：系统正确读取了配置文件中的端口设置
2. 连接建立阶段：端口参数在传递给数据库驱动时丢失或被覆盖
3. 错误处理：系统没有正确处理端口配置错误的场景，直接导致panic

这种类型的问题通常出现在数据库连接池初始化或连接字符串构建环节。在Go语言的数据库驱动实现中，如果端口处理逻辑不完善，就可能出现忽略非标准端口的情况。

影响范围

该问题影响所有满足以下条件的Semaphore v2.10.33用户：

1. 使用MySQL作为后端数据库
2. MySQL服务器运行在非标准端口
3. 通过环境变量或配置文件指定了自定义端口

解决方案

项目维护团队在v2.10.34版本中快速修复了这个问题。修复后的版本正确处理了MySQL连接字符串中的端口参数，确保使用配置中指定的端口号建立连接。

最佳实践建议

对于使用非标准数据库端口的Semaphore用户，建议：

1. 及时升级到v2.10.34或更高版本
2. 在配置文件中明确指定host和port参数
3. 测试环境与生产环境保持一致的数据库端口配置
4. 定期检查Semaphore的日志，确认数据库连接正常

总结

数据库连接是Semaphore这类自动化工具的核心组件，端口配置的正确处理至关重要。这次问题的快速修复展现了开源社区响应问题的效率，也提醒我们在升级版本时需要关注变更日志和已知问题，特别是涉及核心功能的改动。