使用Azure Functions V2 Python（托管标识）向Azure SQL插入数据失败

核心问题定位 #

你的代码存在关键错误：ConnectionStringSetting 参数应填写Function App应用设置中存储的连接字符串名称，而非直接写入完整连接字符串。当前写法会导致托管标识认证逻辑无法正确触发，同时违反配置与代码分离的最佳实践。

修复步骤 #

1. 修正Function代码绑定配置 #

修改@app.generic_output_binding的ConnectionStringSetting值为应用设置名称（例如SqlConnectionString）：

@app.generic_output_binding(arg_name="toDoItems", type="sql", CommandText="dbo.ToDo", ConnectionStringSetting="SqlConnectionString", data_type=DataType.STRING)

2. 在Function App中配置连接字符串 #

进入Azure门户的Function App资源：

• 左侧菜单选择配置 -> 应用程序设置
• 点击新建应用程序设置，添加键为SqlConnectionString，值为SQL连接字符串：

  Server=X.database.windows.net; Authentication=Active Directory Default; Database=X;
  

• 保存配置。

3. 确认托管标识的SQL权限 #

确保Function App的系统分配（或用户分配）托管标识已获得SQL数据库的数据写入权限：

• 进入SQL数据库资源，打开查询编辑器（使用管理员账号登录）
• 执行以下SQL语句（替换<托管标识名称>为你的Function App名称）：

  CREATE USER [<托管标识名称>] FROM EXTERNAL PROVIDER;
  ALTER ROLE db_datawriter ADD MEMBER [<托管标识名称>];
  

  （若需要读取权限，可同时添加db_datareader角色）

4. 验证扩展包兼容性 #

你的host.json中使用的扩展包版本[4.*, 5.0.0)兼容SQL绑定与托管标识，但建议更新至最新4.x版本以规避已知bug。

额外排查点 #

• 检查Function App的系统分配托管标识是否启用：在Function App资源的身份菜单确认状态为开启
• 查看Function日志（Azure门户监控 -> 日志），搜索具体错误信息（如认证失败、权限不足），定位细节问题

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