Golang应用连接Azure PostgreSQL失败：用户名格式错误排查

问题根源 #

Azure PostgreSQL要求用户名必须采用 <username>@<server-host-prefix> 格式，其中<server-host-prefix>是数据库服务器域名的前缀部分（比如some-url-with-dashes.postgres.database.azure.com对应的前缀是some-url-with-dashes）。当前你的用户名缺少@和服务器前缀部分，导致身份验证失败。

解决方案 #

方式一：直接修改环境变量 #

将POSTGRES_USER的值改为符合要求的格式：

POSTGRES_USER="postgresuser@some-url-with-dashes"

方式二：代码中动态拼接用户名 #

如果不想修改环境变量，可以在代码里从DB_HOST提取服务器前缀，和用户名拼接：

import "strings"
import "net/url"

// 提取服务器域名前缀（截取第一个.之前的部分）
serverPrefix := strings.Split(dbHost, ".")[0]
// 拼接符合Azure要求的完整用户名
fullUser := fmt.Sprintf("%s@%s", dbUser, serverPrefix)
// 对密码进行URL编码，避免特殊字符（如!）导致连接串解析错误
encodedPass := url.QueryEscape(dbPass)
// 生成正确的数据库连接串
dbUrl := fmt.Sprintf("postgres://%s:%s@%s:5432/%s", fullUser, encodedPass, dbHost, dbName)
db, err := gorm.Open(postgres.Open(dbUrl), &gorm.Config{})

额外注意事项 #

• 当密码包含!这类特殊字符时，必须用url.QueryEscape做编码处理，否则连接串会被解析错误，引发额外连接问题。
• 确认服务器前缀提取正确：如果你的DB_HOST是xxx.postgres.database.azure.com，前缀就是xxx，不要包含后续的域名后缀。

内容的提问来源于stack exchange，提问作者GMN