HP-Socket服务端初始化失败主因是环境或配置错误；调用GetLastError()查错码，如ERROR_ADDRESS_ALREADY_ASSOCIATED（端口占用）或ERROR_NOT_ENOUGH_MEMORY（线程超限），并确保Initialize()已调用且监听器非nullptr。
HP-Socket 服务端初始化失败：CSocketServer::Start() 返回 false 怎么查
绝大多数人卡在这一步，不是代码写错，而是环境或配置没对。HP-Socket 启动失败时几乎不抛异常，只返回 false，得靠日志和状态码定位。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 调用
CSocketServer::GetLastError()立即获取错误码，常见值：ERROR_ADDRESS_ALREADY_ASSOCIATED（端口被占）、ERROR_NOT_ENOUGH_MEMORY（工作线程数超系统限制） - 确保调用
CSocketServer::Initialize()后，再调用Start()；漏掉Initialize()或传入的IHttpServerListener/ITcpServerListener为nullptr都会静默失败 - Windows 上注意：若启用
SOCKET_FLAG_IOCP，需以管理员权限运行，否则CreateIoCompletionPort失败但 HP-Socket 不报具体原因
监听器回调里拿不到完整 HTTP 请求体：为什么 OnReceive() 只收到半截数据
HP-Socket 的 TCP 层是纯流式收包，不自动拼包、不解析 HTTP。你看到的“半截”，其实是 TCP 分包导致的正常现象，不是框架 bug。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不要在
OnReceive()里直接解析 HTTP header；先缓存到自定义缓冲区（如std::string或环形 buffer），等收到\r\n\r\n再切分 header/body - HTTP 模式下优先用
CHttpServer而非CTcpServer—— 它内置了基础的 header 解析和 chunked 编码支持，OnRequest()回调才保证拿到完整请求 - 若必须用 TCP 模式，记得检查
length参数是否等于本次接收字节数；别假设每次OnReceive()都对应一个逻辑消息
多线程安全边界在哪：Send() 能不能在任意线程调用
可以，但有前提：HP-Socket 允许从非 IO 线程调用 Send()，前提是 socket 连接仍处于活跃状态，且你没手动调用过 Disconnect() 或触发过连接关闭流程。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
Send()是线程安全的，内部会把发送请求投递到对应连接的 IO 线程队列；但返回值仅表示“投递成功”，不代表数据已发出去 - 避免在
OnClose()回调刚返回后立刻调用Send()—— 此时连接可能已被销毁，Send()会返回SOCKET_ERROR并设置WSAENOTCONN - 高并发场景下，频繁跨线程
Send()会增加 IOCP 投递开销；若需批量响应，建议在OnReceive()同一线程内攒批处理
Release 模式下程序崩溃在 HP_SetSocketOption()：为什么 Debug 能跑 Release 就崩
大概率是链接时用了 Debug 版 HP-Socket 库（HpSocket4C_D.lib 或 HpSocket4C_D.dll）配 Release 编译选项，CRT 运行时冲突导致堆损坏。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 检查项目属性 → 配置属性 → 常规 → “使用 MFC” 和 “使用 CRT” 是否与 HP-Socket 库编译时一致；官方预编译库分
_D（Debug）、_MT（多线程静态）、_MD（多线程 DLL）三类 - 用
dumpbin /dependents HpSocket4C.lib查看依赖的 CRT，再对比你项目的/MD或/MT设置 - 更稳妥的做法：自己用 CMake + 同一套 CRT 重新编译 HP-Socket 源码，避免混用二进制分发版
最常被忽略的是 listener 对象生命周期 —— 它必须比 server 实例活得更久，否则 OnReceive() 回调里访问已析构的成员变量，Release 下极难复现又极易崩溃。
