WebFlux+Netty出现InvalidLineSeparatorException警告的排查与修复

环境信息 #

• WebFlux
• 本地HTTP服务（localhost）
• Spring Boot 4
• 无Docker Compose、K8s部署
• 关联组件：Swagger（依赖springdoc-openapi-starter-webflux-ui:3.0.3）、Kafka（依赖spring-kafka，部分端点用于消息发送）

问题现象 #

日志频繁被以下警告污染，请求来源始终为本地127.0.0.1，即使未通过Swagger发送请求也会触发，除此外应用运行正常，无崩溃或功能异常：

2026-05-10T12:34:19.638+03:00 WARN 34088 --- [task-service] [tor-http-nio-10] r.n.http.server.HttpServerOperations : [47c1d912, L:/127.0.0.1:8080 - R:/127.0.0.1:56284] Decoding failed: FULL_REQUEST(decodeResult: failure(io.netty.handler.codec.http.InvalidLineSeparatorException: Line Feed must be preceded by Carriage Return when terminating HTTP start- and header field-lines), version: HTTP/1.0, content: UnpooledByteBufAllocator$InstrumentedUnpooledUnsafeHeapByteBuf(ridx: 0, widx: 0, cap: 0))
GET /bad-request HTTP/1.0

可能原因 #

• 请求格式违反HTTP规范：报错核心是Line Feed must be preceded by Carriage Return，即请求行/头字段的终止符只用了LF（\n），而非HTTP标准要求的CRLF（\r\n），导致Netty解码失败。
• 本地后台进程的自动探测请求：本地监控工具、杀毒软件、浏览器扩展或自定义健康检查脚本等后台进程，可能定期向/bad-request发送格式不规范的请求，这类请求不会经过正常的前端或Swagger调用流程。
• 组件隐性异常请求：Swagger UI组件或Kafka本地客户端可能存在未被察觉的调试/探测请求，格式不符合HTTP规范。

解决方法 #

1. 定位请求来源 #

开启Netty请求日志的详细打印，在application.yml中添加配置：

logging:
  level:
    reactor.netty.http.server.HttpServer: DEBUG

结合日志中的客户端端口（如示例中的56284），用系统工具排查对应进程：

# Windows系统
netstat -ano | findstr :56284
# Linux/macOS系统
lsof -i :56284

找到进程后，若为无用进程可直接停止；若为必要进程，需调整其请求格式以符合HTTP规范。

2. 针对性过滤该类警告 #

若暂时无法定位来源，可单独屏蔽该类Netty警告，不影响其他正常警告输出。在application.yml中添加配置：

logging:
  level:
    reactor.netty.http.server.HttpServerOperations: ERROR

或在logback-spring.xml（对应日志框架配置文件）中添加规则：

<logger name="reactor.netty.http.server.HttpServerOperations" level="ERROR" additivity="false">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="FILE"/>
</logger>

3. 自定义Netty解码器兼容不规范请求 #

若确认来源请求无法修改格式，可自定义Netty的HTTP解码器，允许单独的LF作为换行符：

import io.netty.handler.codec.http.HttpObjectDecoder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import reactor.netty.http.server.HttpServer;

@Configuration
public class NettyHttpServerConfig {
    @Bean
    public HttpServer httpServer() {
        return HttpServer.create()
                .doOnConnection(conn ->
                        conn.addHandlerLast(new HttpObjectDecoder(true) {
                            @Override
                            protected boolean validateHeaders() {
                                // 关闭头字段格式验证，允许LF作为换行符
                                return false;
                            }
                        })
                );
    }
}

注意：此方法会降低HTTP请求的规范性校验，仅在必要场景使用。

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