解决golang-migrate处理特殊字符密码的问题

在使用golang-migrate进行数据库迁移时，如果密码中包含特殊字符如"^"，可能会遇到"net/url: invalid userinfo"的错误。这是因为golang-migrate在解析数据库连接URL时，会按照URL编码规范处理用户名和密码部分。

问题背景

当使用类似"postgres://postgres:pass^word^@localhost:5432/database"这样的连接字符串时，golang-migrate会报错。这是因为URL规范要求某些特殊字符必须进行百分号编码(Percent-encoding)。

解决方案

解决这个问题的方法是对密码中的特殊字符进行URL编码转换：

1. 将"^"字符替换为"%5E"
2. 其他特殊字符也需要相应编码

例如： 原始密码：pass^word^ 编码后：pass%5Eword%5E

技术原理

URL编码是一种将特殊字符转换为安全格式的方法，它使用百分号后跟两个十六进制数字表示字符。对于ASCII字符集中的非字母数字字符，必须进行这种编码。

在PostgreSQL连接字符串中，用户名和密码部分作为URL的userinfo组件，必须遵循URL编码规范。golang-migrate底层使用Go标准库的net/url包解析连接字符串，该包严格执行URL规范。

其他注意事项

1. 不仅仅是"^"字符，其他特殊字符如"@", ":", "/", "?", "#", "[", "]", "!"等也需要编码
2. 空格字符应编码为"%20"或"+"
3. 建议使用专门的URL编码函数处理密码，而不是手动替换
4. 如果密码来自AWS RDS Secret Manager等自动生成的服务，建议先解码再编码

最佳实践

为了避免这类问题，建议：

1. 使用数据库连接池配置而不是直接使用URL字符串
2. 在应用程序中实现自动URL编码逻辑
3. 考虑使用环境变量或配置文件存储敏感信息
4. 对于自动化部署，确保密码生成和URL构建流程正确处理编码

通过遵循这些实践，可以确保golang-migrate在各种密码组合下都能正常工作。