橙心橙怡1. 项目概述
最近在做一个需要快速搭建轻量级HTTP文件服务器的需求，考虑到性能和易用性，最终选择了基于Netty框架实现。这个方案不仅比传统Tomcat等容器更轻量，还能自定义各种文件列表展示和下载逻辑。下面就把整个实现过程和踩坑经验分享给大家。
Netty作为高性能NIO框架，特别适合构建自定义协议的网络应用。用它实现HTTP文件服务器，既能保证吞吐量，又能灵活控制传输细节。核心功能包括：文件目录列表展示、文件下载、基础的路由分发等。实测在普通开发机上就能轻松支撑上千并发请求。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与准备
2.1 为什么选择Netty
相比传统Servlet容器，Netty有几个明显优势：
- 事件驱动的NIO模型，资源占用更少
- 可定制化的HTTP编解码器
- 灵活的Pipeline机制可以插入各种处理器
- 无需依赖完整Web容器
特别适合需要：
- 快速搭建原型
- 对协议有定制需求
- 需要高性能传输
- 轻量级部署的场景
2.2 开发环境准备
基础依赖：
xml复制<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.1.86.Final</version>
</dependency>
推荐使用JDK11+，因为：
- 更好的GC性能
- 对NIO的优化更完善
- 支持var等语法简化代码
3. 核心实现解析
3.1 HTTP服务启动
服务端启动代码示例：
java复制EventLoopGroup bossGroup = new NioEventLoopGroup();
EventLoopGroup workerGroup = new NioEventLoopGroup();
try {
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) {
ch.pipeline()
.addLast(new HttpServerCodec())
.addLast(new HttpObjectAggregator(65536))
.addLast(new FileListHandler(basePath));
}
});
ChannelFuture f = b.bind(port).sync();
f.channel().closeFuture().sync();
} finally {
workerGroup.shutdownGracefully();
bossGroup.shutdownGracefully();
}
关键点说明：
- bossGroup处理连接请求
- workerGroup处理IO操作
- HttpServerCodec用于HTTP编解码
- HttpObjectAggregator合并请求片段
- 自定义的FileListHandler处理业务逻辑
3.2 文件列表生成
核心处理逻辑：
java复制protected void channelRead0(ChannelHandlerContext ctx, FullHttpRequest req) {
// 1. 解析请求路径
String path = sanitizePath(req.uri());
// 2. 检查文件是否存在
File file = new File(basePath, path);
if(!file.exists()) {
sendError(ctx, NOT_FOUND);
return;
}
// 3. 处理目录请求
if(file.isDirectory()) {
if(!req.uri().endsWith("/")) {
sendRedirect(ctx, req.uri() + "/");
return;
}
// 生成HTML列表
String listing = generateDirectoryListing(file);
FullHttpResponse response = new DefaultFullHttpResponse(
HTTP_1_1, OK, Unpooled.copiedBuffer(listing, UTF_8));
response.headers().set(CONTENT_TYPE, "text/html; charset=UTF-8");
ctx.writeAndFlush(response).addListener(ChannelFutureListener.CLOSE);
return;
}
// 4. 处理文件下载...
}
目录列表生成技巧：
- 使用