用oatpp快速启动http服务需继承apicontroller并重写addendpoints()，由appcomponent自动装配；必须调用environment::init()/destroy()；controller构造函数须接收objectmapper；端口绑定需用connectionprovider传":8000"；路由用endpoint宏定义，@path/@body取参需注意类型转换与dto_init宏；404/500需手动配置日志级别和错误处理；链接时须按依赖顺序引入oatpp库且禁用shared。
怎么用 oatpp 快速启动一个 HTTP 服务
直接调 oatpp::web::server::HttpConnectionHandler + oatpp::network::server::Server 就能跑起来，不用写路由注册循环、不用手动管理连接生命周期。核心是定义一个 Controller 子类，重写 addEndpoints()，然后交给 AppComponent 自动装配。
- 别手写
main()里的事件循环——oatpp 提供了oatpp::base::Environment::init()和::destroy()，漏掉前者会导致内存泄漏，后者不调会 crash -
ApiController的构造函数必须接受const std::shared_ptr<objectmapper>&</objectmapper>参数，否则DTO序列化会失败，报错像"No ObjectMapper provided" - 端口绑定失败常见于没加
oatpp::network::tcp::server::ConnectionProvider配置，错误信息是"Failed to bind address"，检查是否传了":8000"而不是"8000"
路由参数和请求体怎么取（GET/POST/JSON）
oatpp 不靠注解或字符串路径匹配，而是用 ENDPOINT_INFO 宏描述接口元信息，再由 ENDPOINT 宏绑定处理函数——这决定了你不能在运行时动态改路由，但编译期就能发现路径冲突。
-
@path取值：写ENDPOINT("GET", "/user/{id}", getUser, PATH(String, id))，id就是String类型变量，不是 raw string；若想转 int，得自己调std::stoi(*id)，别指望自动转换 -
@body解析 JSON：用BODY_DTO，比如BODY_DTO(Object<userdto>, userDto)</userdto>，前提是UserDto有DTO_INIT宏且字段名和 JSON key 一致，否则解析为空对象，无报错 - 表单数据（
application/x-www-form-urlencoded）不被默认支持，要手动读request->getHeader("Content-Type")再 parse，或者换用multipart/form-data+ 第三方库
为什么返回 404 或 500 却没日志
默认日志级别是 WARN，404 属于 INFO，500 异常若没被 ApiController::handleError() 捕获就直接 abort，根本不会进日志管道。
- 启用全量日志：在
main()开头加oatpp::base::Environment::setLogger(std::make_shared<:base::logger::stdlogger>(oatpp::base::logger::StdLogger::Level::ALL))</:base::logger::stdlogger> - 自定义 404：重写
ApiController::getDefaultEndpoint()，返回createResponse(Status::CODE_404)，不然所有未匹配路径都 fallback 到空响应 - 异常没被捕获的典型表现是进程直接退出，堆栈停在
std::terminate，这时要检查ENDPOINT函数里有没有裸 throw，必须用return createResponse(Status::CODE_500)显式返回
构建时链接失败或运行时报 undefined symbol
oatpp 是 header-only + 静态库混合结构，oatpp、oatpp-web、oatpp-test 三个 target 必须按依赖顺序链接，漏一个就会缺 vtable 或 typeinfo。
- CMake 中必须显式 add_subdirectory oatpp 源码目录，不能只 find_package；否则
oatpp::web::server::api::ApiController的虚函数表链接不上 - 如果用 conan，确认 profile 里启用了
shared=False，oatpp 官方不支持动态链接，开 shared 会导致undefined symbol: _ZN5oatpp12web12server3api12ApiControllerD2Ev这类符号找不到 - clang++ 编译时若报
"invalid use of incomplete type"，大概率是忘了#include OATPP_CODEGEN_BEGIN(ApiController)，这个宏展开后才生成 DTO 的反射信息
最麻烦的是 DTO 字段名大小写和 JSON 不一致，它不会报错，只会静默跳过赋值——这种问题只能靠单元测试覆盖输入输出才能暴露。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
