如何在终端使用createdb搭配URI连接串？解决template1报错问题

我完全懂你碰到的这个头疼问题——之前我也踩过类似的坑：用标准PostgreSQL URI连接串在psql里能顺畅连接数据库，但一切换到createdb命令就弹出template1: FATAL的错误。关键是我的环境里postgres用户也设置了密码验证，所有脚本都统一用URI标准、弃用-U这类传统选项，问题就卡在URI标准的适配细节上。

问题根源 #

其实psql和createdb（包括同系列的dropdb、createuser）对URI的处理有个关键差异：

• psql如果URI里没指定数据库名，会默认尝试连接和当前用户名同名的数据库；
• 但createdb是依赖连接template1模板库来执行创建操作的，哪怕URI里没写库名，它也会硬连template1。如果你的postgres用户访问template1的验证配置（比如密码）没匹配上，就会触发致命错误。

符合URI标准的解决方案 #

这里有两个完全遵循URI规范的解决思路，都能让createdb正常工作：

1. 在URI中明确指定连接template1 #

既然createdb默认要连template1，直接把这个库名加到URI里就行，示例命令：

createdb postgresql://postgres:your_password@localhost:5432/template1 -D your_new_database

这里-D参数用来指定你要创建的新数据库名称，URI里的template1是createdb用来执行创建逻辑的目标库。

2. 用--dbname参数分离创建目标与连接URI #

如果你不想在URI里固定写template1，可以用--dbname指定要创建的库，同时确保URI里的验证信息完整，示例：

createdb "postgresql://postgres:your_password@localhost:5432/" --dbname=your_new_database

这种方式下，createdb会用URI里的验证信息连接template1，然后创建你指定的新库。

额外注意事项 #

• 如果你的密码包含特殊字符（比如@、#、&），一定要对这些字符做URL编码（比如@替换为%40，#替换为%23），否则URI会解析失败；
• 检查pg_hba.conf配置，确保postgres用户从localhost访问template1时的验证方式（比如md5或scram-sha-256）和URI里的密码验证逻辑匹配。

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