0 Fork 0

Files

T

qing e815f0ec40 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文档索引

2026-08-07 23:07:35 +08:00

3.8 KiB

Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[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 后进程无法正常退出的多个根本原因：

信号处理安全问题（高）：
- 原信号处理函数调用 std::cout 和 _SERVE->stop() 等非 async-signal-safe 函数，可能导致死锁
- 改为安全模式：仅设置 volatile std::sig_atomic_t 原子标志，使用 write() 输出提示（write 是 async-signal-safe）
- 主线程轮询检测标志后在安全上下文执行关闭流程
SIGPIPE 未处理（中）：
- 新增 SIGPIPE 信号忽略处理，防止写已关闭 socket 时内核意外终止进程
Listener 无限递归 Bug（严重）：
- doAccept() 在 acceptor 关闭后错误分支仍无条件递归调用自身，导致 CPU 100% 空转
- 修复：acceptor 关闭或 operation_aborted 错误时停止接受循环
- 新增 Listener::close() 公开方法，可显式关闭 acceptor 停止接受新连接
stop() 流程顺序问题（中）：
- 改进 HttpServer::stop() 关闭顺序：
  1. 先关闭 acceptor，停止接受新连接
  2. 清空 WebSocket 客户端
  3. 停止 io_context 事件循环
  4. 等待所有 worker 线程退出
  5. 重置 listener
关闭无超时保护（高）：
- 服务器 stop() 添加 8 秒超时保护，超时后 std::exit(1) 强制退出
- 日志 shutdown() 添加 3 秒超时保护，超时后丢弃剩余日志退出
- 保证进程绝不会挂死，极端情况下最多 11 秒内必定退出
启动/关闭架构改进：
- 服务器事件循环改为在独立线程运行，主线程负责信号检测和关闭协调
- 服务器异常退出也能被主线程检测到并正确清理资源

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
密码强度校验

3.8 KiB Raw Blame History Unescape Escape