部署NodeJS至Azure App Service遇PrismaClientInitializationError数据库连接问题

连接字符串格式修正 #

你当前的SQL Server连接字符串格式不符合Prisma的要求，标准格式必须包含以下必要参数：

sqlserver://<host>:<port>;database=<db_name>;user=<username>;password=<password>;encrypt=true;trustServerCertificate=false;

• 必须明确指定端口（默认1433），Azure SQL Server依赖端口建立连接
• 强制添加encrypt=true：Azure SQL要求所有连接必须加密
• trustServerCertificate建议设为false（生产环境标准配置），测试阶段可临时设为true跳过证书验证，但生产环境禁用此设置

Azure环境配置检查 #

• 在Azure App Service的配置 > 应用程序设置中，将数据库连接字符串添加为连接字符串（而非普通环境变量），类型选择SQLServer。Prisma会自动识别Azure的连接字符串配置，避免硬编码泄露敏感信息
• 检查Azure SQL Server防火墙规则：将App Service的所有出站IP地址加入允许列表，或者开启允许Azure服务和资源访问此服务器选项，确保App Service能访问数据库
• 确认数据库用户权限：确保使用的账号拥有db_datareader、db_datawriter等必要操作权限，能正常连接并读写数据库

Prisma部署验证 #

• 本地部署前执行prisma generate，确保生成最新的Prisma Client，并且将node_modules/.prisma目录一同部署；如果使用Azure部署中心（如GitHub Actions），需在部署步骤中添加npx prisma generate命令
• 确保部署环境中正确设置了DATABASE_URL环境变量，值为修正后的连接字符串

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