Azure Portal测试Node.js HTTP触发Azure Function报500错误求助

我之前也踩过这个坑，这个错误其实和Azure Functions近期的配置变更有关，和你的函数代码本身没关系——毕竟直接发起HTTP请求能正常运行，就说明函数逻辑完全没问题。

错误原因拆解 #

错误提示里的genericjson WebHook接收器，是Azure Portal测试工具用来模拟WebHook请求的内置组件。近期Azure对WebHook接收器的验证规则做了更新，要求对应的配置值必须是32-128字符的长度，但Portal测试工具的默认配置没满足这个要求，所以触发了500内部服务器错误。

具体解决方案 #

你可以通过以下两种方式解决：

1. 手动配置函数应用的应用设置（推荐） #

这是最彻底的解决办法：

• 登录Azure Portal，进入你的目标函数应用
• 切换到配置 > 应用程序设置页面
• 查找名为AzureWebJobsGenericJsonWebHookReceiverConfig的设置项：
  • 如果不存在，就新建这个设置，值填一个32-128字符的随机字符串（比如生成一个UUID后去掉横杠，或者自定义复杂的混合字符串）
  • 如果已经存在，检查它的长度是否在32-128字符之间，不够的话就扩展到符合要求的长度
• 保存设置，等待函数应用自动重启后，再用Portal测试工具尝试调用函数

2. 临时替代测试方式 #

如果暂时不想修改配置，你可以用以下方式测试：

• 用Postman、curl这类HTTP客户端直接发送请求（你已经知道这能正常运行）
• 在本地用Azure Functions Core Tools的func start命令启动函数，进行本地调试测试

关于破坏性更新的说明 #

这确实是Azure Functions团队近期推出的一个非预期的破坏性变更，原本是为了加强WebHook接收器的安全性，但没考虑到Portal测试工具的默认配置场景，导致很多用户遇到这个问题。目前官方已经关注到这个情况，后续可能会调整Portal测试工具的默认行为，但现阶段手动配置应用设置是最直接有效的解决办法。

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