CoAP需用libcoap等第三方库实现，因其基于UDP和自定义二进制报文，C++标准库不支持；推荐libcoap（可禁用DTLS/JSON以适配嵌入式），注意URI只支持IP、响应靠回调获取、避免阻塞API。
CoAP不是C++标准库里的东西，得靠第三方库
直接用C++标准库没法发CoAP请求——它底层基于UDP+自定义二进制报文，没有std::coap_send这种函数。你必须选一个成熟、轻量、支持嵌入式环境的C/C++ CoAP库。推荐优先考虑 libcoap（C写，C++可直接链接），而不是自己解析UDP包或套用HTTP库改。
常见错误现象：bind: Address already in use（端口被占）、Connection refused（服务端没开CoAP监听）、收不到响应却无报错（UDP丢包/防火墙拦截）。
-
libcoap3.x 版本起默认启用DTLS，若只跑在局域网且求轻量，编译时加--disable-dtls关掉 - 嵌入式设备内存紧张？禁用JSON/Link-Format解析支持：
--disable-shared --without-mbedtls - 别用
coap_client示例直接塞进你的线程里——它的阻塞式API会卡住整个线程；改用coap_run_once()+ 定时轮询
用libcoap发GET请求的最小可行代码
不是贴完整项目，而是抠出最核心的三步：建上下文、发请求、取响应。其他初始化（日志、信号处理）先砍掉。
// 初始化
coap_context_t *ctx = coap_new_context(nullptr);
coap_address_t dst;
coap_address_init(&dst);
coap_uri_to_address("coap://192.168.1.100/time", &dst); // 注意：不支持域名，只认IP
// 构造请求
coap_pdu_t *pdu = coap_new_pdu(COAP_MESSAGE_CON, COAP_REQUEST_GET, ctx);
coap_add_option(pdu, COAP_OPTION_URI_PATH, 4, (const uint8_t *)"time");
// 发送并等待
coap_tid_t tid = coap_send_confirmed(ctx, &dst, pdu);
coap_read(ctx, 1000); // 阻塞最多1s，实际项目中应配合select/poll使用
// 响应在回调里处理，需提前注册：coap_register_handler(ctx, COAP_REQUEST_GET, hnd_get_time);
关键点：coap_uri_to_address 不解析域名，coap_send_confirmed 返回的是事务ID不是结果，响应靠回调函数拿——很多人卡在这儿，以为发完就结束了。
立即学习“C++免费学习笔记（深入）”；
为什么不用Boost.Beast或Poco写CoAP
它们是为HTTP/WS设计的，强行套用CoAP会踩一堆坑：
- CoAP的
Token字段长度可变（1–8字节），HTTP库没对应抽象，硬塞进headers会错位 - CoAP重传逻辑由客户端自主控制（指数退避），而Boost.Beast的
async_write不暴露重试时机 -
Content-Format是整数编码（如text/plain= 0），不是字符串，Poco的ContentType字段会自动转成字符串导致服务端解析失败 - 性能上，纯CoAP库单次请求内存占用通常
调试时抓不到CoAP包？检查这三处
Wireshark能解CoAP，但默认可能不亮——不是协议问题，是过滤或配置没到位。
- 确保Wireshark已启用CoAP解码：菜单 Analyze → Enabled Protocols → coap 打勾
- 抓包时目标端口必须是
5683（CoAP默认）；如果服务端改了端口，Wireshark不会自动识别，要手动右键→Decode As→CoAP - 用
coap-client -m get coap://[fe80::1%eth0]/status测试IPv6链路时，Wireshark显示“Malformed packet”大概率是因为链路本地地址的zone index（%eth0）没被正确剥离，换用全局IPv6地址再试
真正麻烦的是跨NAT场景：CoAP over UDP在公网穿透能力弱，DTLS握手失败往往静默超时，连错误回调都不触发。这时候别死磕，先切到CoAP over TCP（RFC 8323）或换用MQTT-SN。
