按文档配置Medusa连接PostgreSQL失败求助

问题场景 #

按照Medusa文档要求，PostgreSQL数据库URL格式为：

postgres://[user][:password]@[host][:port]/[dbname]

可通过两种方式配置：

• 项目配置文件中读取环境变量：

module.exports = {
  projectConfig: {
    database_url: process.env.DATABASE_URL,
    // 其他配置项
  },
  // 其他配置
}

• 创建应用时直接通过命令行指定：

npx create-medusa-app@latest --db-url postgres://[user][:password]@[host][:port]/[dbname]

出现的错误 #

使用如下命令创建应用：

npx create-medusa-app@latest --db-url postgres://impctUsr:password@164.90.xxx.xxx:5432/impactcolorDB

收到错误提示：

Couldn't connect to PostgreSQL using the database URL you passed. Make sure it's correct and try again.

若将该URL写入.env文件后执行数据库迁移，会触发TypeError [ERR_INVALID_URL]: Invalid URL: postgres://impctUsr:password@164.90.xxx.xxx:5432/impactcolorDB错误，但本地客户端用相同凭证可以正常连接数据库。

可行的解决办法 #

• 对密码中的特殊字符编码：如果密码包含@、#、$等特殊字符，必须进行URL编码（比如@替换为%40），编码后再拼接成完整的数据库URL。
• 改用分参数配置：放弃URL格式，直接在Medusa配置文件中拆分数据库参数：

module.exports = {
  projectConfig: {
    database_type: "postgres",
    database_host: "164.90.xxx.xxx",
    database_port: 5432,
    database_user: "impctUsr",
    database_password: "password",
    database_name: "impactcolorDB",
    // 其他配置项
  },
  // 其他配置
}

• 检查环境变量解析：在.env中配置URL时，确认没有多余的空格或转义错误，部分环境对特殊字符的解析需要额外处理。
• 验证网络连通性：确认Medusa运行环境能访问目标PostgreSQL服务器的5432端口，虽然本地能连，但服务器可能限制了访问IP。

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