部署后Azure Function App的SQL Trigger无法正常工作

1. 确认应用设置键名与代码引用完全一致 #

• 若代码中用os.environ.get("conn_string")读取连接字符串，Azure应用设置里的键名必须严格为conn_string，大小写敏感，不能有空格或拼写误差。
• 直接从Azure门户「配置」→「应用程序设置」里复制键名到代码，避免手动输入错误。

2. 检查连接字符串格式合规性 #

• Azure环境下的SQL连接字符串需遵循标准格式，示例如下：

  Server=tcp:<server-name>.database.windows.net,1433;Initial Catalog=<db-name>;Persist Security Info=False;User ID=<username>;Password=<password>;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;
  

• 不要给字符串前后加引号，Azure会自动处理格式。

3. 验证SQL Trigger绑定的连接配置 #

• 打开function.json，检查SQL Trigger绑定的connectionStringSetting值，必须与应用设置的键名完全匹配：

  {
    "type": "sqlTrigger",
    "name": "changes",
    "tableName": "<你的表名>",
    "connectionStringSetting": "conn_string",
    "pollingIntervalInMilliseconds": 1000,
    "leaseTableName": "SqlTriggerLeases",
    "createLeaseTableIfNotExists": true
  }
  

• 这是最容易遗漏的配置点，绑定配置不匹配会直接导致触发器找不到连接信息。

4. 排查托管身份权限（若使用该方式） #

• 若未用账号密码，而是通过托管身份连接SQL：
  • 给Function的系统托管身份分配SQL数据库的「SQL DB参与者」角色；
  • 连接字符串需修改为：

    Server=tcp:<server-name>.database.windows.net,1433;Initial Catalog=<db-name>;Authentication=Active Directory Managed Identity;
    

• 同时确保SQL服务器防火墙已勾选「允许Azure服务和资源访问此服务器」。

5. 通过日志定位具体错误 #

• 进入Azure门户的Function App→「监控」→「日志」，打开Application Insights日志，搜索conn_string或SQL Trigger关键词：
  • 若提示Environment variable not found，说明键名不匹配；
  • 若提示登录失败，需检查权限或账号密码正确性。
• 也可通过VS Code的Azure扩展打开「日志流」实时查看报错信息。

6. 重启Function App确保配置生效 #

• 手动添加应用设置后，必须重启Function App才能让新环境变量生效。
• 注意：VS Code部署时不会自动同步local.settings.json的配置到Azure，必须手动在门户添加连接字符串。

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