v-hono/docs/KNOWN_ISSUES.md

已知问题

1. HTTP Keep-Alive 连接复用优化

状态: 已优化 (2025-12-30)

问题描述: 在超高并发（5000 req, 200 concurrent）的 URL Params 测试中出现稳定性问题（成功率仅 0.24%）。

根本原因:

1. picoev 的 max_fds = 1024 限制了并发连接数
2. 虽然设置了 Connection: keep-alive 头，但连接管理不够优化
3. 高并发下客户端端口耗尽（TCP TIME_WAIT 状态累积）
4. 缺少 Content-Length 头导致客户端无法正确解析响应边界

已实施的优化:

1. 增强 Keep-Alive 支持

• 添加 Keep-Alive 响应头，包含 timeout 和 max 参数
• 检测客户端 Keep-Alive 请求头
• 根据客户端请求决定是否保持连接

2. 响应头优化

• 始终设置 Content-Length 头，帮助客户端正确解析响应边界
• 优化 Content-Type 默认值

3. 高并发配置

新增 HighConcurrencyConfig 和 listen_high_concurrency() 方法：

// 使用高并发优化配置启动
app.listen_high_concurrency(8081)

// 或使用自定义配置
config := hono.HighConcurrencyConfig{
    port: 8081
    timeout_secs: 5           // 较短超时
    keepalive_timeout: 3      // Keep-Alive 超时
    max_keepalive_req: 500    // 单连接最大请求数
}
app.listen_high_concurrency_with_config(config)

4. 服务器配置优化

• 降低默认超时时间（8秒 -> 5秒）以更快释放连接
• 增大写缓冲区（8KB -> 64KB）
• 添加 TCP_NODELAY 配置选项

使用建议:

1. 高并发场景使用 --high-concurrency 或 -hc 参数启动服务器
2. 在服务器前部署支持 Keep-Alive 的反向代理（如 nginx）
3. 使用压力测试工具验证: v run examples/stress_test.v

picoev 底层限制:

• max_fds = 1024 是 picoev 的硬编码限制
• 真正的连接复用需要 picoev 底层支持
• 建议关注 V 语言官方对 picoev 的更新

跟踪:

• V 语言 GitHub: https://github.com/vlang/v
• 相关文件: vlib/picoev/picoev.v

更新日期: 2025-12-30