Linux Azure Web App部署项目出现HTTP ERROR 414 URL过长错误求解决方案

你配置的web.config是Windows IIS的专属配置文件，而你的应用部署在Linux Azure Web App 上，运行时用的是Kestrel服务器，默认不会读取web.config的配置，所以修改不生效。可以按以下优先级选择解决方案：

方案一：调整业务传参逻辑（最稳妥，无兼容问题） #

长URL本身就存在浏览器兼容风险，优先建议修改传参方式规避问题：

• 把加密后的大体积flightdata存在前端sessionStorage/localStorage里，跳转新页面后直接从本地存储读取参数
• 或者先调用后端接口把数据存入短过期的临时缓存（如Redis），仅把缓存key放在URL query中传递，新页面加载时用key取回完整数据

方案二：必须保留当前传参逻辑时，修改服务端配置 #

1. 调整Kestrel请求限制 #

在项目Program.cs的CreateHostBuilder方法中添加Kestrel配置，放开请求行/请求头长度限制：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.ConfigureKestrel(options =>
            {
                // 按需调整数值，单位为字节，以下配置设置最大请求行长度为1MB
                options.Limits.MaxRequestLineSize = 1 * 1024 * 1024;
                options.Limits.MaxRequestBufferSize = 2 * 1024 * 1024;
            })
            .UseStartup<Startup>();
        });

2. 调整Azure Linux Web App默认Nginx代理限制 #

Linux Azure Web App默认用Nginx作为反向代理，需要额外配置Nginx放开头部长度限制：

1. 在项目根目录新建nginx.conf文件，添加如下内容：

http {
    server {
        large_client_header_buffers 4 1M;
        client_max_body_size 10M;
    }
}

2. 进入Azure Portal对应Web App的「配置」-「应用程序设置」页，新增配置项：

• 键：NGINX_CONF_INCLUDE
• 值：/home/site/wwwroot/nginx.conf
  保存配置后重启Web App即可生效。

额外排查 #

不同浏览器本身存在URL长度上限，比如Safari最大仅支持约64KB的URL，如果你的URL长度超过了浏览器限制，无论服务端怎么调整都会报错，必须走方案一修改传参逻辑。

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