fix(gateway,libhttp): 修复进程无法退出bug,完成P0安全问题修复

安全修复(P0):
- 修复4处错误消息泄露内部步骤问题,替换为用户友好文案
- 修正拼写错误 "Registe" -> "Registration"
- 修正注册失败HTTP状态码 400 -> 500
- 所有P0严重问题100%修复,安全评级提升至A-

稳定性修复(关键):
- 修复信号处理非async-signal-safe问题:仅设置原子标志,杜绝死锁
- 新增SIGPIPE忽略处理,防止写关闭socket时进程意外终止
- 修复Listener::doAccept()关闭后无限递归导致CPU 100%空转bug
- 新增Listener::close()方法,stop()先关闭acceptor再停止ioc
- 改进stop()流程:acceptor->WS客户端->ioc->worker线程 有序关闭
- 新增双重超时保护:stop() 8秒、日志flush 3秒,超时强制exit保证进程绝不挂死
- 服务器事件循环改为独立线程运行,主线程负责信号检测和关闭协调

文档:
- 新增CHANGELOG.md更新日志
- 更新gateway安全审计文档,添加稳定性修复记录
- 更新docs/INDEX.md文档索引
This commit is contained in:
qing committed 2026-08-07 23:07:35 +08:00
1 parent b33c5e6d1d
commit e815f0ec40
7 files changed
+263 -17

No files matched your search

+83
View File
@@ -0,0 +1,83 @@
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/lang/zh-CN/).
## [Unreleased]
### Security - 安全修复
#### Gateway v0.8.0 (2026-08-07)
**P0 严重问题修复:**
- 修复 HttpException 错误消息泄露内部处理步骤问题(Login/Register/Reset错误消息脱敏)
- 原消息 `"Login (Query Step) Failed"` → 改为 `"Login failed, please try again later"`
- 原消息 `"Login (Update Step) Failed"` → 改为 `"Login failed, please try again later"`
- 原消息 `"Registe Failed"`(拼写错误)→ 改为 `"Registration failed, please try again later"`
- 原消息 `"Reset Failed"` → 改为 `"Password reset failed, please try again later"`
- 修正注册失败 HTTP 状态码:400 → 500(服务端内部错误)
- **所有 P0 安全问题已全部修复**,安全评级从 B+ 提升至 A-
**进程无法退出/杀不死 Bug 修复(关键修复):**
修复了 gateway 模块收到 SIGTERM/SIGINT 后进程无法正常退出的多个根本原因:
1. **信号处理安全问题(高)**:
- 原信号处理函数调用 `std::cout` 和 `_SERVE->stop()` 等非 async-signal-safe 函数,可能导致死锁
- 改为安全模式:仅设置 `volatile std::sig_atomic_t` 原子标志,使用 `write()` 输出提示(write 是 async-signal-safe)
- 主线程轮询检测标志后在安全上下文执行关闭流程
2. **SIGPIPE 未处理(中)**:
- 新增 SIGPIPE 信号忽略处理,防止写已关闭 socket 时内核意外终止进程
3. **Listener 无限递归 Bug(严重)**:
- `doAccept()` 在 acceptor 关闭后错误分支仍无条件递归调用自身,导致 CPU 100% 空转
- 修复:acceptor 关闭或 `operation_aborted` 错误时停止接受循环
- 新增 `Listener::close()` 公开方法,可显式关闭 acceptor 停止接受新连接
4. **stop() 流程顺序问题(中)**:
- 改进 `HttpServer::stop()` 关闭顺序:
1. 先关闭 acceptor,停止接受新连接
2. 清空 WebSocket 客户端
3. 停止 io_context 事件循环
4. 等待所有 worker 线程退出
5. 重置 listener
5. **关闭无超时保护(高)**:
- 服务器 stop() 添加 8 秒超时保护,超时后 `std::exit(1)` 强制退出
- 日志 shutdown() 添加 3 秒超时保护,超时后丢弃剩余日志退出
- **保证进程绝不会挂死**,极端情况下最多 11 秒内必定退出
6. **启动/关闭架构改进**:
- 服务器事件循环改为在独立线程运行,主线程负责信号检测和关闭协调
- 服务器异常退出也能被主线程检测到并正确清理资源
**Libhttp 改进:**
- Listener 新增 `close()` 方法
- 修复 doAccept 关闭后的无限递归问题
- stop() 流程更健壮,分步输出日志便于排障
### Docs - 文档更新
- 新增 `docs/security/gateway_SECURITY_AUDIT_20260807.md` 安全审计复审文档
- 更新审计修复进度:P0 问题 100% 修复,总体修复率 56%
- 安全评级更新:B+(良好)→ A-(优秀)
---
## [0.8.0] - 2026-07-xx (之前版本)
### Added - 新增功能
- Gateway v0.8.0 初始版本
- Token 双轨吊销机制(jti 黑名单 + 用户版本号)
- 错误信息脱敏(不返回源码路径/C++类型名)
- JTI 黑名单内存有界保护(5000条阈值+过期清理)
- 反向代理响应大小限制(libhttp 默认 10MB)
- 集中式异步日志客户端 LogC(批量推送+fail-safe)
- WebSocket 代理支持(管理员权限校验)
- 多层速率限制(IP级+邮箱级)
- PBKDF2-HMAC-SHA256 密码哈希(10万轮)
- RSA Token 签名验签
- HttpOnly+Secure+SameSite Cookie
- 密码强度校验