静态Web App通过Azure Function连接SQL数据库时出现500内部服务器错误

以下是针对你遇到的问题的分步排查方案：

1. 查看Azure Function的详细错误日志 #

500错误属于服务器端异常，首先要获取具体的错误信息：

• 登录Azure门户，进入你的Function App，依次点击监控 > 日志，查看context.log.error输出的详细错误内容，这会直接告诉你连接或查询过程中哪里出了问题（比如认证失败、表不存在、网络连接超时等）。
• 也可以在Function App的平台功能 > 高级工具 > Kudu中，查看LogFiles/Application/Functions/Http/HttpTrigger1下的日志文件。

2. 验证Function的环境变量配置 #

确认Function App的应用程序设置中，以下环境变量是否正确配置：

• DB_USER：SQL数据库的用户名（注意是否包含@servername后缀）
• DB_PASSWORD：数据库用户的密码，确保没有特殊字符转义问题
• DB_SERVER：完整的SQL服务器名称（格式为xxx.database.windows.net）
• DB_NAME：目标数据库的名称
  可以在Azure门户的配置 > 应用程序设置中检查这些值，也可以通过本地调试时的local.settings.json文件验证。

3. 检查SQL数据库的防火墙与网络配置 #

• 除了添加Function的出站IP，确保SQL服务器的防火墙设置中开启了允许Azure服务和资源访问此服务器选项（在SQL服务器的防火墙和虚拟网络设置里），这可以避免因Function出站IP动态变化导致的连接失败。
• 确认你的SQL服务器是公网可访问的（如果使用私有端点，需要额外配置虚拟网络集成）。

4. 检查Function代码的逻辑问题 #

• 连接与查询逻辑：你的当前代码只执行了SELECT * FROM Entries，但未处理前端传入的textInput（你的目标是存储用户输入，需要添加INSERT逻辑）。先确保基础的数据库连接正常，可以先简化代码，只尝试连接数据库不执行查询，看是否还会报错。
• SQL表存在性：确认Entries表在目标数据库中存在，且结构符合预期（比如是否有存储文本的列）。
• 参数化查询：如果后续添加INSERT逻辑，必须使用参数化查询避免SQL注入，示例：

  const { textInput } = req.body;
  if (!textInput) {
      context.res = {
          status: 400,
          body: JSON.stringify({ error: 'textInput不能为空' })
      };
      return;
  }
  const insertResult = await sql.query`INSERT INTO Entries (Content) VALUES (${textInput})`;
  

5. 本地调试Function #

在本地运行Function进行调试，更容易定位问题：

• 将环境变量配置到local.settings.json中：

  {
      "IsEncrypted": false,
      "Values": {
          "AzureWebJobsStorage": "",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "DB_USER": "your-username",
          "DB_PASSWORD": "your-password",
          "DB_SERVER": "your-server.database.windows.net",
          "DB_NAME": "your-db-name"
      }
  }
  

• 使用Postman或curl发送POST请求到本地Function的地址（比如http://localhost:7071/api/HttpTrigger1），查看控制台输出的错误信息。

6. 检查CORS配置（辅助排查） #

虽然当前错误是500，但确认Function App的CORS设置中已添加你的静态Web App域名，避免后续出现跨域问题。在Azure门户的CORS设置中添加静态Web App的完整域名（包括https://前缀）。

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