使用TitaniumAS.Opc.Client时OPC-DA AddGroup空引用错误排查

可能原因分析 #

1. server对象未正确初始化 #

你的StartConnection方法中，若连接过程抛出异常（如URL构建失败、OPC服务器不可达），server变量会保持未赋值的null状态。后续直接判断server.IsConnected时会触发空引用，更不用说调用AddGroup了。

2. DCOM权限配置问题（高概率） #

OPC-DA基于DCOM通信，权限配置错误会导致服务器拒绝创建组，最终AddGroup返回null：

• 客户端与服务器的DCOM权限未开放
• 跨机器访问时，用户身份不匹配（非域账号/无管理员权限）
• 防火墙阻断了DCOM端口（默认135+动态端口）

3. IsConnected属性误判 #

TitaniumAS.Opc.Client的IsConnected可能存在延迟，连接未完全建立就返回true，导致调用AddGroup时服务器未就绪。

解决办法与代码修复 #

代码层面修复 #

修改StartConnection和构造函数，增加null校验与异常捕获：

public OpcDaGroup opcDaGroup;
private OpcDaServer server; // 确保为类级成员变量

private void StartConnection(string Cls_Id, string Machine_IpAddress)
{
    try
    {
        log.Debug("START - Starting the connection");
        Uri url = UrlBuilder.Build(Cls_Id, Machine_IpAddress);
        server = new OpcDaServer(url);
        server.Connect();
        log.Debug("END   - Starting the connection");
    }
    catch (Exception e)
    {
        log.Error("Could not connect to the OPC server for the IpAddress: {0}", e);
        server = null; // 连接失败显式置空，避免后续误判
    }
}

public OpcDaAdapterThreadImpl(string Cls_Id, string Machine_IpAddress, string name, ICollection<TagConfigurationModel> tags)
{
    this.Cls_Id = Cls_Id;
    this.Machine_IpAddress = Machine_IpAddress;
    this.name = name;
    this.AdapterReady = true;
    Tags = tags;
    
    // 标签分组逻辑保留
    var group = tags.GroupBy(c => new { ItemName = c.TagName }).Select(c => c.Key).Distinct();
    grouptags = group.Select(c => new TagConfigurationModel { TagName = c.ItemName }).ToList();
    opcTagItems = grouptags.Select(c => new OpcDaItemDefinition { ItemId = c.TagName, IsActive = true }).ToList();
    
    StartConnection(Cls_Id, Machine_IpAddress);
    
    // 先校验server非空，再判断连接状态
    if (server != null && server.IsConnected)
    {
        try
        {
            opcDaGroup = server.AddGroup("Group");
            if (opcDaGroup == null)
            {
                log.Error("Failed to create OPC group: AddGroup returned null");
                return;
            }
            opcDaGroup.IsActive = true;
            opcDaGroup.AddItems(opcTagItems);
        }
        catch (Exception ex)
        {
            log.Error("Error during group/item addition: {0}", ex);
        }
    }
    else
    {
        log.Warn("OPC server is not connected or server object is null");
    }
}

DCOM权限配置步骤 #

1. 运行dcomcnfg打开组件服务
2. 找到目标OPC服务器的组件（如KepServerEX对应Kepware.KEPServerEX.V6）
3. 右键属性→安全选项卡：
   • 启动和激活权限：添加当前运行程序的用户，赋予允许权限
   • 访问权限：同上，开放对应用户的访问权限
4. 远程服务器需开放防火墙DCOM端口（135固定端口，或配置OPC服务器使用固定动态端口）
5. 确保客户端与服务器使用同一域账号，或本地管理员账号（跨机器时）

额外排查技巧 #

• 用OPC测试工具（如OPC Quick Client）连接目标服务器，验证服务器可用性与标签合法性
• 查看Windows事件查看器的系统日志，排查DCOM权限相关错误事件

内容的提问来源于stack exchange，提问作者vignesh