Azure Function发布后端点不显示且无法调用问题求助

一、解决配置发布后被重置的问题 #

• 检查发布工具设置：使用VS/VS Code发布时，确认未勾选"应用设置同步"选项，该选项会强制覆盖Azure端的现有配置；若之前误勾选，重新发布时取消该选项，或在发布预览中排除应用设置项。
• ARM/Bicep部署场景：确保部署模板使用mode:Incremental模式，而非Complete模式，避免覆盖已配置的参数；同时确认模板内的配置参数与预期一致。
• Azure CLI发布：添加--settings-preserve参数保留现有配置，命令示例：

  func azure functionapp publish <你的函数应用名称> --settings-preserve
  

二、端点不显示/无法调用的排查步骤 #

1. 匹配运行时版本：本地项目的运行时版本（如.NET 6隔离模式、Python 3.9等）、架构（x64/x86）必须与Azure函数应用的配置完全一致，可在门户的「函数应用>配置>常规设置」中核对。
2. 校验Kudu文件完整性：在Kudu的wwwroot目录下，确认函数的function.json存在且格式正确，重点检查bindings节点的route、authLevel配置；隔离模式.NET函数需确认host.json中extensions.http.routePrefix配置（默认值为api）。
3. 分析活动日志错误：
   • 若报错「Function runtime is unreachable」：核对配置>应用设置中的AzureWebJobsStorage、WEBSITE_CONTENTAZUREFILECONNECTIONSTRING（文件存储场景）连接字符串有效性，确保存储账户与函数应用网络可达（优先同区域部署）。
   • 若报错「Assembly not found」：确认本地项目依赖包已全部发布至Kudu，比如.NET项目的bin目录是否包含完整DLL、Python项目的site-packages是否存在依赖包；可尝试本地清理后重新发布，或使用func pack打包后再部署。
4. 重启函数应用：在门户的「函数应用>概述」中点击「重启」，修复运行时加载异常导致的问题。
5. 检查应用服务计划状态：消耗计划需排除冷启动影响（若持续不可用则排除此可能）；专用计划需确认实例无资源不足、运行异常情况。

三、额外验证操作 #

• Kudu控制台测试：在Kudu调试控制台中执行func start启动运行时，查看函数加载状态及报错信息。
• 网络配置排查：若函数应用开启VNet集成或IP限制，确认调用IP在允许列表内，可暂时关闭IP限制测试访问情况。

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