drogon项目初始化失败主因是cmake未指定安装路径：需用-dcmake_install_prefix=/usr/local安装并设cmake_prefix_path；路由404因未显式注册；异步查询空结果因未在回调处理；undefined reference因漏target_link_libraries(drogon::drogon)。
drogon 项目初始化失败：cmake 报错找不到 Drogon
常见现象是 find_package(Drogon REQUIRED) 报错，提示 Could not find a package configuration file provided by "Drogon"。根本原因不是 Drogon 没装，而是没告诉 cmake 去哪找——它默认只查系统路径（如 /usr/lib/cmake/Drogon），而 drogon 的 install 步骤默认不把 config 文件放进去。
- 装 drogon 时务必加
-DCMAKE_INSTALL_PREFIX=/usr/local（或你指定的路径），再执行sudo make install - 你的项目
CMakeLists.txt中，find_package(Drogon REQUIRED)前必须加set(CMAKE_PREFIX_PATH "/usr/local")（路径要和 install 一致） - Mac 上用 brew 装的 drogon，config 路径通常是
/opt/homebrew/lib/cmake/Drogon，对应设CMAKE_PREFIX_PATH即可 - 不推荐用
add_subdirectory(drogon)直接嵌入源码——编译慢、链接易冲突、升级麻烦
HTTP 路由绑定后收不到请求：GET /api/user 总是 404
drogon 不像 Express 那样自动扫描函数名或路径字符串，所有路由必须显式注册，且大小写、斜杠结尾、HTTP 方法都严格匹配。
- 确保在
main()里调用了app().registerHandler("/api/user", ...)，而不是只写了 handler 函数却忘了注册 - 检查 handler 函数签名是否为
void(const HttpRequestPtr&, std::function<void httpresponseptr>)</void>，少一个参数或类型不对，编译可能过但运行时静默失效 - 如果用了
ADD_METHOD_HANDLER宏，注意宏展开后实际注册的是"/api/user"，不是"api/user"或"/api/user/"（末尾斜杠不等价） - 启动后看控制台日志，正常会有
Registered path: /api/user [GET]这类输出；没看到就说明注册没生效
异步数据库查询返回空结果：MySQL 查询始终拿不到数据
drogon 的 DbClient 所有操作默认异步，回调函数里的 result 是唯一数据来源，直接 return 或赋值外部变量基本无效。
- 别写
auto r = client->execSqlAsync(...); return r;——r是Task<result></result>类型，不是结果本身 - 必须在回调 lambda 里处理数据：
client->execSqlAsync("SELECT * FROM users", [this](const Result &r) { handleUsers(r); }); - 如果需要同步等待（仅测试/简单场景），用
client->execSqlSync()，但它会阻塞当前 IO 线程，线上禁用 - 确认连接串里指定了正确的 database 名，drogon 不会自动创建或切换 DB，
mysql://user:pass@127.0.0.1:3306/mydb缺mydb就查不到表
编译报错 undefined reference to `drogon::HttpResponse::newHttpResponse()`
这是典型的链接阶段失败，说明头文件能包含（#include <drogon></drogon> 没问题），但链接器找不到 drogon 库的符号实现。90% 是 CMakeLists.txt 里漏了 target_link_libraries。
- 确保
add_executable(myapp main.cc)后紧跟target_link_libraries(myapp PRIVATE Drogon::Drogon) - 不要写成
target_link_libraries(myapp PRIVATE drogon)—— 导出的 target 名是Drogon::Drogon，不是小写 - 如果用
pkg_check_modules方式找库，需手动加target_link_libraries(myapp PRIVATE ${DROGON_LIBRARIES})，且确保${DROGON_LDFLAGS}已传入 linker - 静态链接时（
-DBUILD_SHARED_LIBS=OFF），还要额外 linkpthread和ssl/crypto，否则同样报这类 undefined reference
drogon 的配置粒度比想象中细，比如 HttpResponse::newHttpJsonResponse() 和 newHttpResponse() 底层依赖不同组件，漏连一个库就崩一个函数。别跳过 cmake 的 --debug-output，它会打印实际链接了哪些 .so 文件。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
