Prisma启用Accelerate后执行migrate dev遇SASL认证失败如何解决？

针对配置Accelerate后运行npx prisma migrate dev出现的FATAL: SASL authentication failed错误，按以下步骤排查解决：

• 确认DIRECT_DATABASE_URL的正确性
  Prisma Migrate需要直接连接PostgreSQL数据库（Accelerate仅用于Prisma Client查询），所以DIRECT_DATABASE_URL必须是数据库的原生连接字符串，而非Accelerate提供的代理地址。检查：

  • 用户名、密码、主机、端口、数据库名是否完全正确
  • 密码中的特殊字符（如@、#、!）是否已做URL编码（比如@替换为%40）

• 检查PostgreSQL的认证配置
  登录数据库服务器，查看pg_hba.conf文件，确认对应连接方式的认证规则：

  • 如果使用scram-sha-256认证（PostgreSQL 10+默认推荐），确保你的数据库用户已设置对应的加密密码（而非md5）
  • 若暂时排查困难，可临时将对应条目改为md5认证，测试是否能正常连接，再逐步调整回安全配置

• 验证环境变量加载
  确保.env文件中的DIRECT_DATABASE_URL没有拼写错误，且运行npx prisma migrate dev的环境能正确读取该变量。可以通过运行以下命令验证：

  echo $DIRECT_DATABASE_URL
  

  输出的内容应与数据库的正确连接字符串一致。

• 核对Prisma与PostgreSQL版本兼容性
  你的Prisma版本为5.5.2，确保对应的PostgreSQL版本在兼容范围内（Prisma 5.x支持PostgreSQL 10至16）。若数据库版本过旧或过新，可能存在认证协议不兼容的问题。

• 临时禁用directUrl测试
  暂时注释schema.prisma中的directUrl = env("DIRECT_DATABASE_URL")，将DATABASE_URL替换为原生数据库连接字符串，运行npx prisma migrate dev。如果能成功执行，说明问题出在DIRECT_DATABASE_URL的配置上，重新检查该变量即可。

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