NextJS 13+Prisma+SQL Server部署Azure应用服务时Prisma配置报错

核心排查方向及解决步骤 #

1. 检查Azure SQL Server防火墙规则 #

Azure SQL Server默认阻止外部非授权访问，本地能连接是因为你的IP在允许列表中，但部署到Azure App Service后，服务出站IP不在规则内会导致连接拒绝：

• 登录Azure门户进入目标SQL Server资源
• 打开「防火墙和虚拟网络」设置
• 勾选「允许Azure服务和资源访问此服务器」选项；或手动将App Service的所有出站IP（在App Service「属性」中查看）添加到防火墙规则

2. 修正Prisma构建脚本 #

Next.js standalone输出模式下，必须确保构建时生成适配生产环境的Prisma Client，否则会出现驱动缺失问题：
修改package.json的scripts字段，在构建、开发命令前加入prisma generate：

"scripts": {
  "dev": "prisma generate && next dev",
  "build": "prisma generate && next build",
  "start": "node .next/standalone/server.js",
  "lint": "next lint"
},

3. 验证Azure环境变量配置 #

确认Azure App Service中SQLCONNSTR_DATABASE_URL的格式符合Prisma要求，正确的SQL Server连接字符串格式为：

sqlserver://<server-name>.database.windows.net:1433;database=<db-name>;user=<username>;password=<password>;encrypt=true;trustServerCertificate=false;connectTimeout=30

• 检查变量名严格为SQLCONNSTR_DATABASE_URL（Prisma自动识别该前缀的环境变量）
• 确认用户名、密码、服务器地址无拼写错误，特殊字符已正确转义

4. 升级依赖版本 #

教程使用的Node.js 13已停止维护，与新版Prisma存在兼容性风险：

• 将Node.js版本升级到LTS版（如18.x或20.x），并在Azure App Service「配置」-「常规设置」中同步设置对应运行时版本
• 升级Prisma依赖到最新稳定版，确保prisma与@prisma/client版本一致：

npm install prisma@latest @prisma/client@latest

5. 确认Prisma Schema配置 #

当前prisma.schema的数据源配置无需额外修改，确保provider字段为sqlserver即可：

datasource db {
  provider = "sqlserver"
  url      = env("SQLCONNSTR_DATABASE_URL")
}

验证流程 #

1. 本地执行npm run build后运行npm run start，模拟生产环境确认数据库连接正常
2. 重新部署到Azure Web Service，查看日志是否仍存在连接错误

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