基于App Service Plan的Azure函数应用超时时间无法修改求助

Hey Matthieu，我来帮你梳理下这个头疼的超时问题——我之前也帮不少开发者排查过类似情况，大概率是某个容易忽略的细节没到位，咱们一步步来排查：

首先确认最关键的前提：你的App Service Plan层级够不够？ #

这是很多人踩坑的第一点：只有Basic、Standard、Premium或Isolated层的App Service Plan，才能把函数超时调到5分钟以上。如果你的Plan是Free(F1)或者Shared(D1)，平台有硬限制，不管你怎么改host.json都没用，必须升级到更高层级才能调整超时时间。

先去Azure门户看看你的App Service Plan定价层，确认不是Free/Shared层，再往下看。

1. 检查host.json的配置和部署情况 #

首先确保你的host.json格式完全正确，JSON对符号要求很严，少个逗号或者引号不对都可能导致配置不生效：

{
  "version": "2.0",
  "functionTimeout": "00:10:00"
}

然后要确认这个文件在函数应用的根目录（不是某个具体函数的文件夹里），而且Visual Studio发布时确实把它传到Azure了：

• 在Visual Studio里右键host.json，选「属性」，把「复制到输出目录」改成「始终复制」，避免发布时遗漏。
• 去Azure门户打开函数应用的「高级工具(Kudu)」，点「Debug console」→「CMD」，进入site/wwwroot目录，看看有没有host.json，内容是不是和你本地的一致。

2. 部署槽的配置有没有正确生效？ #

如果你用了部署槽，要注意几个点：

• 槽的配置是「槽特定」的吗？只有标记为槽特定的设置才不会和生产槽同步。
• 你是在槽的host.json里改的超时，还是用应用设置？如果是应用设置，键名得是AzureFunctionsJobHost__functionTimeout（注意是双下划线），值设为00:10:00。
• 交换槽的时候，有没有勾选「交换配置」？没选的话，槽里的超时设置不会同步到生产槽。

3. 确认你的函数运行时模式 #

如果你的函数是**隔离进程(Isolated Process)**模式（比如.NET 5及以上的项目常选这个），超时配置根本不在host.json里！得在Program.cs里配置：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.Configure<WorkerOptions>(options =>
        {
            options.ApplicationWorkerTimeout = TimeSpan.FromMinutes(10);
        });
    })
    .Build();

你可以去Azure门户的函数应用「配置」→「常规设置」里看「运行时堆栈」，如果带「Isolated」标识，就是这个模式，得改Program.cs的配置。

4. 排查应用设置里的冲突 #

有时候Azure门户的应用设置里会有AzureFunctionsJobHost__functionTimeout这个键，它的优先级比host.json高，会直接覆盖你的配置。
去函数应用的「配置」→「应用程序设置」里搜这个键，如果存在，要么把值改成00:10:00，要么直接删掉这个键，让host.json的配置生效。

最后别忘了重启！ #

不管你改了什么配置，都得重启函数应用才能生效。去门户的函数应用概览页点「重启」，等重启完再测试超时时间。

如果还是不行，去Kudu的日志里搜functionTimeout相关的内容，看看启动时系统有没有加载到你的配置值，或者有没有报错，这能帮你快速定位问题。

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