v-hono/docs/README_BENCHMARK.md

veb vs v-hono 性能对比测试

测试文件说明

文件	说明
benchmark_veb_vs_hono.v	路由匹配性能测试（纯路由，不启动服务器）
server_veb.v	veb HTTP 服务器示例（端口 8080）- V 语言官方新版 web 框架
server_vweb.v	vweb HTTP 服务器示例（端口 8080）- 旧版兼容
server_hono.v	v-hono HTTP 服务器示例（端口 8081）
http_benchmark.v	HTTP 压测工具（自动对比两个服务器）
run_benchmark.ps1	Windows PowerShell 一键测试脚本

快速开始

Windows 用户（推荐）

cd examples
.\run_benchmark.ps1

1. 路由匹配性能测试

cd examples
v run benchmark_veb_vs_hono.v

2. HTTP 服务器压测

方式一：使用内置压测工具

终端 1 - 启动 veb 服务器：

v run server_veb.v

终端 2 - 启动 v-hono 服务器：

v run server_hono.v

终端 3 - 运行压测：

v run http_benchmark.v

方式二：使用 wrk 或 ab

# 测试 veb
wrk -t4 -c100 -d10s http://localhost:8080/
wrk -t4 -c100 -d10s http://localhost:8080/api/users/123

# 测试 v-hono
wrk -t4 -c100 -d10s http://localhost:8081/
wrk -t4 -c100 -d10s http://localhost:8081/api/users/123

或使用 Apache Bench：

ab -n 10000 -c 100 http://localhost:8080/
ab -n 10000 -c 100 http://localhost:8081/

3. 编译优化版本（推荐用于正式压测）

cd examples
v -prod server_veb.v -o server_veb.exe
v -prod server_hono.v -o server_hono.exe
v -prod http_benchmark.v -o http_benchmark.exe

测试结果分析

路由匹配性能

路由类型	简单路由器 (模拟 vweb)	v-hono FastRouter
静态路由	~1000 ns/op	~9500 ns/op
动态路由	~15000-25000 ns/op	~9500 ns/op

结论：

• 静态路由：简单路由器更快（直接 map 查找）
• 动态路由：v-hono 更快且更稳定（使用缓存和优化的正则匹配）
• v-hono 的优势在于动态路由性能一致，不随路由复杂度增加而显著下降

测试端点

端点	类型	说明
GET /	静态	Hello World
GET /api/health	静态	健康检查
GET /api/users	静态	获取用户列表
POST /api/users	静态	创建用户
GET /api/users/:id	动态	获取单个用户
GET /api/users/:id/posts	动态	获取用户的帖子
GET /api/users/:user_id/posts/:post_id	动态	获取特定帖子
GET /api/categories/:cat/items/:item	动态	获取分类商品

测试结果分析

路由匹配性能

路由类型	SimpleRouter (模拟 veb)	v-hono FastRouter
静态路由	~1000 ns/op	~9500 ns/op
动态路由	~15000-25000 ns/op	~9500 ns/op

HTTP 吞吐量（参考值）

端点类型	veb	v-hono	说明
静态路由	~15000 req/s	~12000 req/s	veb 略快
动态路由	~8000 req/s	~10000 req/s	v-hono 更稳定

注：实际性能取决于硬件配置和系统负载

结论

• 静态路由：veb/SimpleRouter 使用 map 直接查找，通常更快
• 动态路由：v-hono 使用 Trie + 缓存，性能更稳定
• v-hono 优势：动态路由性能一致，不随路由复杂度增加而显著下降
• veb 优势：官方支持，与 V 语言生态集成更好

测试端点

端点	类型	说明
GET /	静态	Hello World
GET /api/health	静态	健康检查
GET /api/users	静态	获取用户列表
POST /api/users	静态	创建用户
GET /api/users/:id	动态	获取单个用户
GET /api/users/:id/posts	动态	获取用户的帖子
GET /api/users/:user_id/posts/:post_id	动态	获取特定帖子
GET /api/categories/:cat/items/:item	动态	获取分类商品

注意事项

1. veb vs vweb：veb 是 V 语言官方的新版 web 框架，替代了旧的 vweb
2. 编译优化：正式压测时请使用 -prod 编译优化版本
3. 预热：测试前建议先发送一些请求预热服务器
4. 环境隔离：压测时关闭其他占用 CPU 的程序