创建变量用户名角色后无法连接PostgreSQL数据库

可能的原因及对应解法 #

1. 密码变量未加引号导致存储异常 #

你的脚本中创建角色的语句是：

create role :user_username with LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE inherit password :user_password;

这里的:user_password替换后没有被单引号包裹，而PostgreSQL要求密码必须是字符串字面量（用单引号括起来）。当你通过命令行传入-v user_password='myPassword'时，psql替换后会变成password myPassword，这会被PostgreSQL解析为标识符而非密码字符串，导致实际存储的密码并非你预期的myPassword。

解法：修改脚本，给密码变量加上单引号：

create role :user_username with LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE inherit password ':user_password';

2. 用户名变量未加双引号导致大小写被自动转换 #

PostgreSQL对未加双引号的标识符（包括用户名）会自动转换为小写。假设你传入的用户名是MyUsername（含大写字母），脚本中create role :user_username替换后会变成create role MyUsername，PostgreSQL会自动将其转为myusername存储。但你测试连接时用的是MyUsername，大小写不匹配就会导致认证失败。

解法：如果需要保留用户名的大小写，修改脚本给用户名变量加上双引号：

create role ":user_username" with LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE inherit password ':user_password';

同时确保测试连接时使用的用户名大小写与传入的完全一致。

3. Shell解析变量时的转义问题 #

如果你的密码包含特殊字符（比如$、!、空格、单引号等），命令行中直接用-v user_password='myPassword'会被Shell解析，导致实际传入psql的密码并非你输入的内容。例如密码是my$Password，Shell会把$Password解析为环境变量（如果不存在则为空），最终传入的密码变成my。

解法：用双引号包裹密码变量的赋值，避免Shell转义：

psql $myConnection -v ON_ERROR_STOP=1 -v user_password="myPassword" -v user_username=myUsername  -f '/scripts/initializedatabase.pgsql'

如果密码本身包含双引号，需要用反斜杠转义：-v user_password="my\"Password"

4. 确认角色创建的上下文正确性 #

虽然Docker日志显示脚本执行成功，但需确认执行脚本时使用的连接用户（$myConnection对应的用户）拥有创建角色的权限。可以通过以下命令验证角色是否存在：

psql $myConnection -c "SELECT rolname FROM pg_roles WHERE rolname='myUsername';"

如果查询不到该角色，说明脚本执行时可能没有正确创建角色，需检查$myConnection的连接参数是否正确指向目标数据库实例。

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