Ktor Server（EngineMain）部署Azure App Service出现400错误排查

我运行的是基于Netty的Ktor Server，之前使用EmbeddedServer，为适配YAML配置文件切换为EngineMain后，出现400 Bad Request错误。想确认Ktor Server是否默认会校验请求头并返回400？

当前使用Ktor版本2.3.0，应用未配置RequestValidation{}或StatusPages模块，不确定添加这些模块是否有用。已添加StatusPages模块，但所有错误都会触发它。奇怪的是，此问题仅出现在Azure App Service中，本地运行时服务响应正常。

请求信息：

GET / HTTP/1.1
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8
Host: xxx-yyyyyy-zzzzzzzzzz-aaaaa.azurewebsites.net
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0
Accept-Encoding: gzip, deflate, br
Accept-Language: en-US
Max-Forwards: 10
DNT: 1
Sec-Fetch-Dest: document
Sec-Fetch-Mode: navigate
Sec-Fetch-Site: none
Sec-Fetch-User: ?1
X-ARR-LOG-ID: c0e417c3-aaaa-bbbb-cccc-ddddcd626ef9
CLIENT-IP: x.x.x.x:45628
X-Client-IP: x.x.x.x
DISGUISED-HOST: xxx-yyyyyy-zzzzzzzzzz-aaaaa.azurewebsites.net
X-SITE-DEPLOYMENT-ID: xxx-yyyyyy-zzzzzzzzzz-aaaaa-aaa__f6ad
WAS-DEFAULT-HOSTNAME: xxx-yyyyyy-zzzzzzzzzz-aaaaa.azurewebsites.net
X-Forwarded-Proto: https
X-AppService-Proto: https
X-ARR-SSL: 2048|256|CN=Microsoft Azure TLS Issuing CA 02, O=Microsoft Corporation, C=US|CN=*.azurewebsites.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US
X-Forwarded-TlsVersion: 1.2
X-Forwarded-For: x.x.x.x:45628
X-Original-URL: /
X-WAWS-Unencoded-URL: /
X-Client-Port: 45628

响应信息：

HTTP/1.1 400 Bad Request
Content-Length: 0
Connection: close

• Ktor本身默认不会主动校验请求头，但底层依赖的Netty会执行基础的HTTP规范校验（比如请求格式、头字段合法性），不符合规范的请求会直接返回400。
• 本地与Azure环境的差异核心原因：Azure App Service的反向代理会添加大量自定义请求头（如X-ARR-SSL、X-ARR-LOG-ID等），部分头的格式可能触发Netty的严格校验规则，而本地环境无这些额外头，因此不会报错。
• 关于RequestValidation{}和StatusPages模块：
  • RequestValidation{}用于校验请求参数、Body内容，默认未启用，与当前400问题无关。
  • StatusPages模块仅能捕获全局错误并自定义响应，无法直接解决400的根源，需先定位错误原因再使用。

排查与解决步骤 #

1. 开启详细日志：在YAML配置文件中设置日志级别为DEBUG，查看Netty抛出的具体异常信息，定位触发400的具体请求头或规则。配置示例：

   logging:
     level:
       io.ktor: DEBUG
       io.netty: DEBUG
   

2. 调整Netty配置：通过EngineMain的YAML配置修改Netty的校验规则，比如禁用严格的请求头校验。示例配置：

   ktor:
     deployment:
       port: 8080
     application:
       modules: [com.example.ApplicationKt.module]
     server:
       netty:
         configureServer:
           option:
             ALLOW_HALF_CLOSURE: true
         pipeline:
           add:
             - name: "validator"
               factory: "io.netty.handler.codec.http.HttpObjectAggregator"
               arguments: [1048576]
   

3. 拦截请求头排查：添加请求拦截器，打印所有请求头，对比本地与Azure环境的差异，重点检查Azure特有的头字段格式是否符合HTTP规范。示例代码：

   install(CallLogging) {
       level = LogLevel.INFO
       filter { call -> call.request.path() == "/" }
       logger = Logger.SIMPLE
       mdc("headers") { call ->
           call.request.headers.entries().joinToString(", ") { "${it.key}: ${it.value}" }
       }
   }
   

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