Azure Functions从v6降级到v4后ADF调用Web Activity报404错误排查

背景：将Azure Functions从v6降级到v4后，使用Azure Data Factory（ADF）通过HTTP请求调用该函数时出现如下404错误：

Invoking Web Activity failed with HttpStatusCode - '404 : NotFound',
message - 'The requested resource does not exist on the server. Please verify the request server and retry'

下面说明该问题与存储账户变更、网络配置的关联可能性：

存储账户变更的影响 #

Azure Functions v4与v6对存储账户的依赖逻辑存在差异，降级后若出现以下情况，可能触发404错误：

• 存储账户的连接字符串未同步更新，或函数应用系统身份对存储账户的Blob、队列权限被修改，会导致函数初始化失败，对外的调用端点无法正常响应。
• 若降级过程中更换了存储账户，需确认新账户内是否包含函数运行必需的容器（如azure-webjobs-hosts、azure-webjobs-secrets），缺失这类容器会导致函数服务异常，直接返回404。

网络配置的影响 #

网络层面的问题也可能引发该404错误：

• 若函数应用启用了虚拟网络集成或IP限制，降级后未同步调整网络规则，ADF的IP地址可能被拦截，请求无法抵达函数服务，部分场景下拦截会返回404而非403，易被误认为资源不存在。
• 降级后函数的自定义域名配置异常，或ADF中配置的调用URL仍使用旧的v6端点路径，也会出现资源找不到的404错误。

额外排查提示（结合VS Code bin目录文件） #

从你提供的bin目录文件来看，还可排查以下几点：

• 降级后生成的v4编译文件是否完整，是否缺失Microsoft.Azure.Functions.Worker这类核心依赖dll，文件损坏或缺失会导致函数无法启动，端点自然不可用。
• 本地调试能否正常触发函数：如果本地运行正常，大概率是云端的存储或网络配置问题；如果本地也报错，需检查项目的host.json是否已调整为v4的配置格式（v4与v6的host.json结构存在差异）。

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