Prisma连接MongoDB遇DNS解析错误，请求排查连接问题

问题详情 #

配置Prisma Schema连接MongoDB时触发以下错误：

Error: MongoDB error
Kind: An error occurred during DNS resolution: proto error: io error: 通訊端操作嘗試連線到一個無法連線的網路。 (os error 10051), labels: {}
0: schema_core::commands::schema_push::Calculate from
at schema-engine\core\src\commands\schema_push.rs:29
1: schema_core::state::SchemaPush
at schema-engine\core\src\state.rs:436

使用的schema.prisma配置：

generator client {
  provider = "prisma-client-js"
  // previewFeatures = ["views"]
}

datasource db {
  provider = "mongodb"
  url      = env("DATABASE_URL")
}

排查步骤 #

• 校验连接字符串格式
  确保DATABASE_URL符合MongoDB规范：

  • 本地实例：mongodb://localhost:27017/你的数据库名
  • 远程集群（如Atlas）：mongodb+srv://<用户名>:<密码>@集群地址.mongodb.net/你的数据库名?retryWrites=true&w=majority
    检查是否遗漏用户名、密码，特殊字符需做URL编码。

• 测试网络连通性

  • 用MongoDB Compass或mongo命令行直接连接目标实例，确认网络通路正常。
  • 本地环境检查MongoDB服务是否启动；远程集群需确认当前IP已加入白名单。
  • 临时关闭防火墙、代理工具，排查是否是网络拦截导致无法连接。

• 检查DNS解析能力

  • 针对SRV格式的连接字符串，在终端执行nslookup 你的集群域名，验证是否能正常返回IP地址。
  • 若DNS解析失败，尝试切换公共DNS（如8.8.8.8），或改用IP地址直接连接（仅适用于非SRV格式）。

• 确认版本兼容性
  检查Prisma版本与MongoDB版本是否匹配，建议升级到最新稳定版：

  npm install prisma@latest
  

• 清理Prisma缓存
  删除生成的客户端文件并重新生成：

  npx prisma generate
  npx prisma db push
  

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