如果接手过产线数据采集，肯定遇到过这种场面：现场几台西门子 S7-1200 或者倍福控制器负责生产节拍，MES 要采集几十个点位，最后往往被协议转换搞得焦头烂额。早期我们直接通过 Modbus TCP 一个点一个点 mapping，后面发现西门子、倍福这些主流控制器已经原生内置了 OPC UA 服务器，PLC 程序里启用一下服务，上位机直接就能读。开源库里我最常用的就是 open62541，纯 C 写的跨平台库，协议栈完整，既能做客户端也能做服务器，尤其适合嵌入式网关和上位机软件集成。
这篇文章把我在实际项目里用 open62541 读写 PLC 的 OPC UA 节点流程拆开讲，包括库编译、客户端连接、节点浏览、数据读写、订阅，以及那些文档里不会写的坑。内容主要以做一个轻量级 Linux 网关为例，从零到一把数据读上来，并且回写控制指令。适合正在搞设备数据采集、MES 对接、工业物联网网关的工程师，也适合刚接触 OPC UA 的 PLC 工程师和上位机开发。
1. 为什么是 OPC UA，为什么选 open62541
1.1 OPC UA 不是 Modbus 的简单加强版
Modbus 的问题是“地址即一切”，线圈、保持寄存器、输入寄存器全靠一张点位表解释。这张表经常存在 Excel 里，调试的时候两个人各拿一版，字段对不上就完蛋。OPC UA 的信息模型自带命名空间、对象、变量、方法，节点的语义在服务器端就能描述清楚，上位机可以通过浏览自动发现下面有什么数据，不用在接线图上找人问半天。这一点在生产设备数量多的场景里非常省事。
OPC UA 另一个强项是安全模型，有证书校验、加密、签名。Modbus/TCP 几乎裸奔，稍微复杂一点的工厂网络审计都过不去。OPC UA 支持用户名密码登录，也支持 X.509 客户端证书，基本能满足大多数等保和客户审计要求。
1.2 open62541 这个库的实际优势
open62541 是开源实现里最活跃的之一。它用 C99 编写，没有强制依赖外部第三方库，编译出来体积小，在 ARM 嵌入式板子上也能跑。我做过一个基于树莓派和 RK3568 的采集网关，整个 open62541 静态库加定制功能后不超过 2MB，非常合适。
它最方便的是支持“整合模式”，即 amalgamation，编译生成一个open62541.c和一个open62541.h，直接扔进自己工程参与编译，不用调整 CMake、不用管动态库版本。很多项目都这么干，省心。
如果你只会用 C++ 或者要快速实现功能，open62541 还提供了高层的 C API，本质上还是 C 封装，没有 C++ 那种复杂模板。社区文档齐全，GitHub 上示例很多。它还自带一个纯 C 的 OPC UA 服务器示例，意味着你可以在没有真实 PLC 的时候先在本地开一个模拟服务器，专门用来联调客户端。
1.3 方案选型：客户端还是服务器
open62541 同时支持客户端和服务器，选型时要想清楚。
我的习惯是：如果 PLC 本身已经内置了 OPC UA 服务器，那就让 open62541 做纯客户端去连 PLC；如果现场是很老的 PLC 或者没有 OPC UA 能力的控制器，我又不想买商业网关，就会在工控机上用 open62541 搭一个 OPC UA 服务器，把 Modbus RTU 采集到的数据重新聚合映射成 UA 节点，给 MES 用。
这里要提醒一句：凡是能用 PLC 原生 OPC UA 服务器的，尽量不要自己再包一层网关。多一层转发就多一个故障点，延迟、状态同步、变量类型都会踩坑。只有老设备迫不得已才用网关方案。
2. 环境准备与库编译
2.1 从源码快速构建 open62541
在 Ubuntu 或 Debian 上构建非常直接。我一般用 v1.3 或 v1.4 发行分支，稳定性和 API 变更都在可控范围内。
git clone https://github.com/open62541/open62541.git cd open62541 git checkout v1.3 mkdir build && cd build cmake -DUA_ENABLE_AMALGAMATION=ON -DUA_NAMESPACE_ZERO=FULL .. make -j4编译完成后，build目录下会生成open62541.c、open62541.h、libopen62541.a。如果只是做客户端，建议再加两个选项：
cmake -DUA_ENABLE_AMALGAMATION=ON -DUA_NAMESPACE_ZERO=FULL \ -DUA_ENABLE_SUBSCRIPTIONS=ON -DUA_ENABLE_NODEMANAGEMENT=OFF ..订阅功能默认可能是开关的，做数据变化监控必须打开。NODEMANAGEMENT是做服务器时才需要的，纯客户端可以关掉，减小体积。
注意：如果你的编译器是 GCC 老版本，某些新版本的 open62541 可能要求 C99 以上标准。我建议直接用 GCC 9 或更高版本，Windows 上用 MSVC 2019 以上。另外交叉编译到 ARM 板子时，CMake 里要指定工具链文件，不要直接用宿主机编译器碰运气。
2.2 工程里怎么引用 open62541
我自己常用的做法是把open62541.c和open62541.h直接放进项目源码目录，在 CMakeLists.txt 里添加：
add_executable(plc_gateway src/main.c third_party/open62541.c) target_include_directories(plc_gateway PRIVATE third_party) target_link_libraries(plc_gateway PRIVATE pthread m)如果你不希望make每次把几万行的 open62541.c 全量编译一遍，可以把它编成静态库单独放好，再让主工程链接。不过原型阶段我懒，直接编进去，反正增量编译也就一次。
如果是在 Windows 上做上位机原型，用 Visual Studio 打开项目，把open62541.c拖进去，编译器设置成 C 编译模式即可。还有 NuGet 包，也可以直接引用，不过版本更新往往比源码滞后，遇到 bug 不好处理。
2.3 小工具先行：用 UA Expert 验证服务器
动手写代码之前，强烈建议先用 UA Expert 或 UaExpert 这个免费工具连接 PLC，验证一下服务器到底是什么数据模型。UA Expert 是 OPC Foundation 出的，Windows/Linux 都有，支持浏览节点树、看数据类型、读写变量、建订阅。
我第一次连西门子 S7-1200 时，端口设错成 4840 之外的自定义端口，半天没连上。用 UA Expert 一分钟就能看到服务器端点和安全策略，还能直接把某个节点的 NodeId 复制出来，格式类似ns=3;s="DeviceSet"."PLC_1"."CurrentTemperature"。有了这个 NodeId，写代码就不需要猜了。
经验之谈：很多厂家的 PLC 内置 OPC UA 服务器默认是不启用的。西门子 S7-1200/1500 需要先在 TIA Portal 里启用“OPC UA 服务器”，并且设置安全策略、端口，还要开放防火墙端口。如果 UA Expert 都连不上，不要怀疑代码，先回 PLC 那边把服务打开。
3. 客户端连接 PLC 的核心流程
3.1 连接前先弄清三件事
用 open62541 写客户端连接 PLC，第一步不是写代码，而是把下面三样东西问清楚：
- 服务器地址：
opc.tcp://192.168.1.10:4840 - 安全策略：
None、Basic256Sha256还是Basic128Rsa15 - 认证方式：匿名、用户名密码、证书
很多 PLC 默认可能是匿名 + None，但工厂安全策略要求启用加密。open62541 对加密的支持默认可能关闭，编译时需要加-DUA_ENABLE_ENCRYPTION=MBEDTLS，并链接 mbedTLS。否则客户端证书配置好了，连接时也会报BadSecurityPolicyRejected。
3.2 用默认配置连接最快
在没有特殊安全要求、纯内网调试阶段，最小连接代码是：
#include <open62541/client.h> #include <open62541/client_config_default.h> #include <open62541/client_highlevel.h> #include <stdio.h> int main(void) { UA_Client *client = UA_Client_new(); UA_ClientConfig_setDefault(UA_Client_getConfig(client)); UA_StatusCode retval = UA_Client_connect(client, "opc.tcp://192.168.1.10:4840"); if (retval != UA_STATUSCODE_GOOD) { printf("连接失败: %s\n", UA_StatusCode_name(retval)); UA_Client_delete(client); return 1; } printf("连接成功\n"); UA_Client_disconnect(client); UA_Client_delete(client); return 0; }注意UA_ClientConfig_setDefault会自动配置日志和超时。如果想要加密和用户名密码，需要手动修改配置结构。比较常见的做法是：
UA_ClientConfig *config = UA_Client_getConfig(client); UA_ClientConfig_setDefault(config); config->securityMode = UA_MESSAGESECURITYMODE_SIGNANDENCRYPT; UA_ClientConfig_setSecurityPolicyUserPassword(config, certificate, certLen, privateKey, keyLen, "username", "password");setSecurityPolicyUserPassword这种函数在较新版本里才提供，旧版本没有。如果你用的 v1.2 或更老，只能自己去填securityPolicyUri和clientDescription等字段。我建议直接上 v1.3 以上。
3.3 浏览节点：从根节点找到你的标签
连接成功后，下一条命令就是浏览。OPC UA 服务器的对象节点不像 Modbus 寄存器那样有固定地址，它是一棵节点树。根节点起始于 ObjectsFolder，即ns=0;i=85。
用 open62541 发浏览请求：
UA_BrowseRequest bReq; UA_BrowseRequest_init(&bReq); bReq.requestedMaxReferencesPerNode = 1000; bReq.nodesToBrowseSize = 1; bReq.nodesToBrowse = UA_Array_new(1, &UA_TYPES[UA_TYPES_BROWSEDESCRIPTION]); bReq.nodesToBrowse[0].nodeId = UA_NODEID_NUMERIC(0, UA_NS0ID_OBJECTSFOLDER); bReq.nodesToBrowse[0].resultMask = UA_BROWSERESULTMASK_ALL; UA_BrowseResponse bResp = UA_Client_Service_browse(client, bReq); if (bResp.responseHeader.serviceResult == UA_STATUSCODE_GOOD) { for (size_t i = 0; i < bResp.resultsSize; i++) { UA_ReferenceDescription *refs = bResp.results[i].references; for (size_t j = 0; j < bResp.results[i].referencesSize; j++) { printf("节点: %.*s, NodeId: ", (int)refs[j].displayName.text.length, refs[j].displayName.text.data); UA_NodeId_print(&refs[j].nodeId.nodeId); printf("\n"); } } } UA_Array_delete(bResp.results, bResp.resultsSize, &UA_TYPES[UA_TYPES_BROWSERESULT]); UA_RequestHeader_clear(&bReq.requestHeader); UA_Client_delete(client);UA_NodeId_print可以在控制台打印出ns=...;i=...或ns=...;s=...格式，方便复制。有的 PLC 服务器提供对象和变量，有的还暴露了DeviceSet、ParameterSet之类的文件夹，浏览时要注意层级。
不过实际写采集程序时，我不建议每次都从根节点递归浏览，数据量大时很慢，而且很多隐藏节点会干扰。更好的方式是先用 UA Expert 找到目标节点的 NodeId，写死在配置文件里，代码直接按 NodeId 读取。
3.4 节点 ID 的几种写法
open62541 中，节点 ID 有两种常见形式：
- 数字型：
ns=2;i=1001 - 字符串型：
ns=3;s=MyDevice.Temperature
代码里解析字符串：
UA_NodeId nodeId; UA_StatusCode r = UA_NodeId_parse(&nodeId, "ns=2;i=1001", true); if (r != UA_STATUSCODE_GOOD) { printf("NodeId 解析失败: %s\n", UA_StatusCode_name(r)); return; } UA_NodeId_clear(&nodeId);也可以直接构造数字型：
UA_NodeId nodeId = UA_NODEID_NUMERIC(2, 1001);注意UA_NODEID_NUMERIC三个参数不是数量，而是namespaceIndex和identifier。第一个参数2是命名空间索引，第二个1001才是实际节点编号。不要写反。
如果 PLC 厂家文档给出的 NodeId 是ns=3;s="DeviceSet"."PLC_1"这种带引号的字符串，解析时不要自己去掉引号，最好完整粘贴。我见过有同事手写解析逻辑把引号丢了，结果始终BadNodeIdUnknown。
4. 读写变量的实际代码与数据类型坑
4.1 读取一个节点的标准套路
读取节点值的接口是UA_Client_readValueAttribute。注意它读的是节点的 Value 属性，如果读错属性或者节点类型不对，会报BadAttributeIdInvalid。
UA_Variant value; UA_Variant_init(&value); UA_StatusCode retval = UA_Client_readValueAttribute(client, nodeId, &value); if (retval == UA_STATUSCODE_GOOD) { if (UA_Variant_isScalar(&value)) { if (UA_Variant_hasScalarType(&value, &UA_TYPES[UA_TYPES_FLOAT])) { UA_Float f = *(UA_Float*)value.data; printf("数值: %.2f\n", f); } else if (UA_Variant_hasScalarType(&value, &UA_TYPES[UA_TYPES_INT16])) { UA_Int16 i = *(UA_Int16*)value.data; printf("数值: %d\n", i); } } } UA_Variant_clear(&value);这里的重点在于，OPC UA 的变量自带数据类型，读取后要先用UA_Variant_hasScalarType或UA_Variant_hasArrayType判断，再转换。很多新手直接拿*(UA_Int32*)value.data去打印 Int16，得到的结果就是乱码，浪费两个小时还找不到原因。
4.2 批量读取：别一次一次读
如果采集点数超过几十个，不要写循环一个节点一个节点读。open62541 支持一次ReadRequest里放多个ReadValueId，网络往返只有一次，性能差异非常明显。300 个点逐个读可能要好几百毫秒，批量读一次能压到几十毫秒。
UA_ReadRequest req; UA_ReadRequest_init(&req); const char *nodeIds[] = {"ns=2;i=1001", "ns=2;i=1002", "ns=2;i=1003"}; size_t count = 3; req.nodesToReadSize = count; req.nodesToRead = UA_Array_new(count, &UA_TYPES[UA_TYPES_READVALUEID]); for (size_t i = 0; i < count; i++) { UA_ReadValueId_init(&req.nodesToRead[i]); UA_NodeId_parse(&req.nodesToRead[i].nodeId, nodeIds[i], true); req.nodesToRead[i].attributeId = UA_ATTRIBUTEID_VALUE; } UA_ReadResponse resp = UA_Client_Service_read(client, req); if (resp.responseHeader.serviceResult == UA_STATUSCODE_GOOD) { for (size_t i = 0; i < resp.resultsSize && i < count; i++) { if (resp.results[i].status == UA_STATUSCODE_GOOD) { printf("节点 %zu 读取成功\n", i); /* 根据 resp.results[i].value 的数据类型再处理 */ } } } UA_ReadResponse_clear(&resp); UA_ReadRequest_clear(&req);注意UA_Client_Service_read和UA_Client_readValueAttribute之间的关系。后者其实就是对前者内置的一次封装。批量读时最好在同一个请求里带上所有需要的点，返回结果的顺序和请求顺序一一对应，不需要靠 NodeId 排序。
4.3 写入：常被权限和类型坑
写入时最容易踩的坑是“类型不匹配”。比如 PLC 里的模拟量输出是Int16，你写了个 C 语言的int（通常是 int32）进去，open62541 会直接把 Variant 类型标成Int32，服务器多半拒绝，报BadTypeMismatch。
正确做法是指定和服务器一致的类型：
UA_Int16 setpoint = 1500; UA_Variant var; UA_Variant_init(&var); UA_Variant_setScalar(&var, &setpoint, &UA_TYPES[UA_TYPES_INT16]); UA_StatusCode retval = UA_Client_writeValueAttribute(client, nodeId, &var); if (retval == UA_STATUSCODE_GOOD) { printf("写入成功\n"); }还要注意，写 OPC UA 变量有时不光是写 Value 属性，写完之后要确认是否真的生效。有些 PLC 内部对写入值做了上下限限制，比如电流上限不能超过 1600，写 2000 虽然服务器返回Good，实际值可能被 PLC 程序钳位了。这种情况不是协议层问题，要回 PLC 程序里查。
4.4 订阅数据变化：用事件代替轮询
数据采集点多了以后，轮询不仅慢，而且浪费服务器资源。对变化不敏感的数据，比如设备启停状态、报警，建议用订阅方式，服务器主动上报。open62541 的原生订阅 API 稍微绕一点，但用熟了就顺手。
先订阅一个数据变化回调：
static void dataChangeCallback(UA_Client *client, UA_UInt32 subId, void *subContext, UA_UInt32 monId, void *monContext, UA_DataValue *value) { if (!value || value->hasValue == false) { return; } /* 这里处理上报的数据 */ if (UA_Variant_hasScalarType(&value->value, &UA_TYPES[UA_TYPES_BOOLEAN])) { printf("状态变化: %d\n", *(UA_Boolean*)value->value.data); } }然后创建订阅：
UA_CreateSubscriptionRequest request = UA_CreateSubscriptionRequest_default(); request.requestedPublishingInterval = 200.0; request.requestedMaxKeepAliveCount = 10; UA_CreateSubscriptionResponse response; UA_Client_Subscriptions_create(client, request, &response); UA_MonitoredItemCreateRequest monRequest = UA_MonitoredItemCreateRequest_default(nodeId); UA_Client_MonitoredItems_createDataChange( client, response.subscriptionId, UA_TIMESTAMPSTORETURN_BOTH, monRequest, dataChangeCallback, NULL);这时候主线程不能直接退出，open62541 客户端的事件处理依赖一个后台循环。最简单的是UA_Client_run_iterate(client, 50);放在一个 while 循环里，或者直接调用UA_Client_run，它会阻塞运行直到调用UA_Client_disconnect。
我用订阅最多的地方是设备状态点，比如某个工位是否在报警。如果设备 5 秒内没有上报，我还需要配合一个看门狗逻辑，不能只靠服务器推送。常见做法是每个订阅对象登记最后上报时间，超时自动标记通信中断。
5. 常见问题与排错实录
5.1 连接失败 / BadSecurityPolicyRejected
这个问题在我接手过的项目里出现过无数次。多数情况是 PLC 服务器配置的是某个加密策略，客户端用None去连。UA Expert 连接时它默认会自动选择安全策略，但自己用 open62541 写时，UA_ClientConfig_setDefault配置的默认策略往往不是服务器想要的。
解决办法是先用 UA Expert 查看服务器端点的安全模式，然后在客户端代码里显式设置。如果只是内网调试，图省事可以在 PLC 服务器配置里把安全策略改成None，但不建议生产环境这么做。
另外如果编译时没有打开加密支持，即使你在代码里设置了安全策略，也会报BadSecurityPolicyRejected。重新编译 open62541 前确认命令里有-DUA_ENABLE_ENCRYPTION=MBEDTLS。
5.2 读到空值 BadNoData / BadNodeIdUnknown
BadNodeIdUnknown大概率是 NodeId 的命名空间索引写错了。比如 UA Expert 显示ns=3;i=1200，你看到数字格式就习惯性写成ns=2，这必然读不到。
BadNoData则可能意味着节点本身存在，但当前没有可读的值。常见于 PLC 中变量还没有被程序初始化，或者服务器对某些状态节点禁止读取。此时可以先确认 PLC 程序是否已经运行，变量是否连线到了实际 IO。
还有一个隐蔽问题：有些服务器返回的数据状态码是Good，但value.hasValue是false，表示节点存在但没有值。这时候不能直接打印，要先判断value.hasValue。
5.3 写入不生效：BadNotWritable 与用户权限
写入时报BadNotWritable，可能是节点属性是只读的。OPC UA 节点不仅有 Value 属性，还有 AccessLevel 属性。PLC 变量区不是所有变量都允许上位机写，有些在 PLC 程序里被声明成读取专用。
还有用户权限问题。如果服务器启用了用户名密码，匿名用户可能只有只读权限。写操作需要在配置里设置用户角色或者把用户名密码改成有写权限的账户。
我遇到过一个问题：写入返回Good，但 PLC 里的值纹丝不动。最后查出来是因为我写的是地址ns=2;i=1100，而这个节点是 PLC 程序里某个 DB 的“临时副本”，不是实际输出。PLC 程序每个扫描周期会把实际输出覆盖上去。解决办法是找到真正的输出地址，或者在 PLC 程序里把写进来的值用作实际输出。
5.4 数据类型混了：Int16 当 UInt16 读
OPC UA 对数据类型的区分比 C 语言严格得多。同一个 PLC 变量，在服务器里可能是UInt16，你用Int16去转换，负数和大于 32767 的数值都是错的。还有一种常见情况，PLC 里的实数可能是Float也可能是Double，如果你默认按Double打印，Float的字节会被读成很大的错误数值。
我写了个通用的类型打印函数来处理这个问题，代码大概长这样：
static const char* uaTypeToString(const UA_DataType *type) { if (type == &UA_TYPES[UA_TYPES_BOOLEAN]) return "Bool"; if (type == &UA_TYPES[UA_TYPES_INT16]) return "Int16"; if (type == &UA_TYPES[UA_TYPES_UINT16]) return "UInt16"; if (type == &UA_TYPES[UA_TYPES_INT32]) return "Int32"; if (type == &UA_TYPES[UA_TYPES_UINT32]) return "UInt32"; if (type == &UA_TYPES[UA_TYPES_FLOAT]) return "Float"; if (type == &UA_TYPES[UA_TYPES_DOUBLE]) return "Double"; if (type == &UA_TYPES[UA_TYPES_STRING]) return "String"; return "Unknown"; }配合调试日志，至少能快速知道服务器返回的类型，不会瞎猜。
5.5 掉线重连与看门狗
工业现场网络从来不是稳定的。交换机重启、网线被踩、PLC 断电，都会导致客户端掉线。open62541 本身没有自动重连机制，但在很多场景下又不能把采集服务退出。我习惯做一个独立线程，每隔 2 秒检查连接状态。
代码思路不复杂：
static UA_StatusCode ensureConnected(UA_Client *client) { if (UA_Client_getState(client) == UA_CLIENTSTATE_CONNECTED) { return UA_STATUSCODE_GOOD; } UA_StatusCode retval = UA_Client_connect(client, SERVER_URL); if (retval == UA_STATUSCODE_GOOD) { /* 重连成功后要重新创建订阅 */ createSubscriptions(client); } return retval; }注意，断线后之前创建的订阅会自动失效，重新连接后必须重新创建 MonitoredItems。如果没有重新订阅，你会发现自己断线重连之后再也没有数据上报。
5.6 不同 PLC 厂家的默认配置差异
西门子 S7-1500 内置 OPC UA 服务器默认开启，S7-1200 需要固件版本足够并且手动启用；倍福 TwinCAT 里需要在设置中启用 UA 服务器，并把端口映射到 4840；欧姆龙 NJ/NX 系列也可以启用，但节点结构和西门子差异很大。
我吃过最大的亏是不同厂家的 NodeId 命名规范不同。西门子常用字符串节点 ID，例如ns=3;s="DeviceSet"."PLC_1"."Temperature"；倍福有时候用数字 ID；还有一些国产 PLC 直接把数据模型做成十几个数组节点，浏览时满屏都是数组元素。
每周踩一次的数据采集经验告诉我：无论厂家文档写得多漂亮，第一件事永远是连上去看，别照着文档凭空猜。
6. 几个血泪经验与调试技巧
6.1 用 Node-RED 做中转验证 OPC UA 转 MQTT
现场有段时间需要把 OPC UA 数据转到 MQTT 给云端，我们用了 Node-RED。Node-RED 有现成的 OPC UA 节点和 MQTT 节点，发布流程很顺畅。调试时我会让 Node-RED 同时订阅 PLC 的 OPC UA 节点和 open62541 客户端读取的节点，对比结果。这样能非常快地确认问题出在 open62541 上还是 PLC 服务器上。
如果你只是想在 PC 上快速清洗数据，Node-RED 是个不错的选择。但它毕竟是 Node.js 生态，现场长期稳定运行我建议还是用 C 写网关程序，内存占用小，崩溃概率低。
6.2 仿真环境与虚拟机的网络选择
现场不是随时有真实 PLC。我经常在 VMware 里跑 PLC 仿真软件，然后用虚拟机里的 open62541 客户端连宿主机里的服务器。最容易翻车的是网络模式。
我用 VMware 时一般把 PLC 仿真环境和客户端放在同一个 NAT 网络段，或者直接把网卡调成桥接模式。桥接模式下虚拟机相当于一台独立机器，能和真实 PLC 直连。如果用默认 NAT 模式，虚拟机访问真实 PLC 时，目标地址需要写成宿主机实际 IP 而不是虚拟网卡 IP，很多同事在这上面耗过很长时间。
还有一点：仿真软件的 OPC UA 服务端口可能每次启动随机变化。最好在软件设置里固定端口，否则你代码里写死的opc.tcp://192.168.x.x:4840会突然失效。
6.3 日志要开着，尤其是 UA_Client 日志
open62541 默认日志在 stderr 上，编在客户端里很容易忽略。调试阶段强烈建议至少看一轮日志，它能告诉你握手失败在哪一步。可以在 main 函数里设置自定义日志：
UA_ClientConfig *config = UA_Client_getConfig(client); config->logger = (UA_Logger) { .log = myLogger, .context = NULL, .clear = NULL };如果不想写自定义日志，直接把标准日志插件导入就行。日志信息里会包含SecureChannel建立状态、SecurityPolicy匹配过程、请求响应状态码，80% 的连接问题看日志就能定位。
6.4 读写测试的万能小技巧
最后分享一个很土但很好用的技巧：拿到任何一台新 PLC，我先用 open62541 写一个“只浏览不读值”的小程序，把服务器节点树全部打出来，保存成文本。用这个文本做数据字典，后续写采集点就不会乱。整个过程类似给设备拍照存档，越早做越省事。
有些服务器节点树很大，比如上千个节点，浏览请求里的requestedMaxReferencesPerNode设小了会分页，很多库不会自动翻页，导致只打印了第一页。我一般直接设成 10000，避免分页问题。
如果你的 PLC 服务器还提供历史数据节点，也可以先用 UA Expert 读一段历史数据，确认历史存储有没有开启。现场遇到某台设备“数据空白”，往往不是 open62541 问题，而是服务器端历史记录压根没配置。
