MedusaJS本地运行报错ERR_INVALID_URL：数据库连接URL格式存疑

可能的原因及修复方案 #

1. 未替换连接字符串中的占位符 #

你当前使用的是模板格式的连接字符串，但错误日志显示实际传入的是postgres://user:pass@host:port/db——这说明你直接使用了占位符文本，没有替换成真实的PostgreSQL配置信息。

修复：
替换成本地PostgreSQL的真实参数，比如本地默认配置的示例：

postgres://postgres:你的密码@localhost:5432/medusa_db

注意：

• postgres是默认PostgreSQL用户名，若自定义过则用自己的用户名
• 你的密码是安装PostgreSQL时设置的密码
• localhost为本地数据库地址，远程数据库替换为对应IP
• 5432是默认端口，自定义过端口则用对应值
• medusa_db是你提前为Medusa创建的数据库名称（必须先手动创建该数据库）

2. 密码包含URL特殊字符未编码 #

如果PostgreSQL密码里有@、:、/、%这类URL保留字符，直接写入连接字符串会导致解析失败。

修复：
对密码中的特殊字符进行URL编码，示例映射：

• @ → %40
• : → %3A
• / → %2F
• % → %25
  比如密码是Pass@123/，编码后连接字符串应为：

postgres://postgres:Pass%40123%2F@localhost:5432/medusa_db

3. 连接字符串格式存在语法错误 #

检查是否有以下问题：

• 密码为空时，不要保留:password部分，直接写成postgres://user@host:port/dbname
• 端口为默认5432时可省略，写成postgres://user:pass@host/dbname
• 不要遗漏用户名与主机之间的@符号
• 确保数据库名称是已提前创建的有效名称

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