PyInstaller打包OPC UA客户端后通信中断问题解决咨询

问题背景 #

PyCharm中正常运行的OPC UA客户端代码，经PyInstaller打包为.exe后，通信会在数秒或数分钟后中断，报错包含BadSecurityChecksFailed、No future object found for request、CancelledError，客户端类由线程调用。

具体修复步骤 #

1. 补全PyInstaller打包时的隐式依赖 #

opcua库的部分加密、线程相关模块无法被PyInstaller自动检测到，需手动指定：

• 方式一：创建并修改spec文件，添加hiddenimports：

# your_script.spec
a = Analysis(
    ['your_script.py'],
    # ...其他配置
    hiddenimports=['opcua.crypto', 'opcua.ua', 'concurrent.futures', 'cryptography.hazmat.backends', 'cryptography.hazmat.primitives'],
    # ...其他配置
)

• 方式二：打包命令直接指定隐式依赖：

pyinstaller --hidden-import opcua.crypto --hidden-import opcua.ua --hidden-import concurrent.futures --hidden-import cryptography.hazmat.backends --hidden-import cryptography.hazmat.primitives your_script.py

2. 启用安全通道超时并添加保活机制 #

开启安全通道超时设置，同时定时发送心跳请求维持连接：
修改connect方法：

def connect(self):
    try:
        self.client.set_security(policy=security_policies.SecurityPolicyBasic256Sha256,
                                 certificate_path=self.root_path+CERT_RELATIVE_PATH,
                                 private_key_path=self.root_path+PRIVATE_KEY_RELATIVE_PATH,
                                 mode=MessageSecurityMode.SignAndEncrypt
                                 )
        self.client.application_uri = "urn:script:opcua"

        self.client.secure_channel_timeout = 30000  # 30秒，匹配服务器配置
        self.client.session_timeout = 60000

        self.client.connect()
        self.root_node = self.client.get_root_node()
        self.call_method('ns=2;s=/Methods/GiveUserAccess', 'OpcUaClient', 'GudWrite')
        
        # 启动保活线程
        import threading
        import time
        def keep_alive():
            while self.client.is_connected():
                try:
                    # 读取服务器状态节点维持连接
                    self.client.get_node('ns=0;i=2258').get_value()
                    time.sleep(10)
                except Exception as e:
                    self.main_log.warning(f"保活失败: {e}")
                    self.reconnect()
        threading.Thread(target=keep_alive, daemon=True).start()
        
        return True
    except Exception:
        self.main_log.info('无法连接NC: {}'.format(traceback.format_exc()))
        raise custom_exceptions.UnableToConnect()

3. 显式控制请求超时与Future生命周期 #

修改数据读取方法，添加超时参数，避免Future对象意外回收：

def get_battery_100(self):
    try:
        node = self.client.get_node('ns=2;s=/NC/_N_NC_GD2_ACX/DG_BATTERY_TIME')
        # 设置5秒超时，确保请求在有效周期内完成
        data_value = node.get_data_value(timeout=5000)
        return data_value.Value.Value
    except (ua.UaError, concurrent.futures.CancelledError) as e:
        self.main_log.warning(f"读取电池数据失败: {e}，尝试重连")
        self.reconnect()
        # 重试一次读取
        return self.client.get_node('ns=2;s=/NC/_N_NC_GD2_ACX/DG_BATTERY_TIME').get_value()

4. 完善重连机制 #

添加通用重连方法，在连接中断时自动恢复：

def reconnect(self):
    try:
        if self.client.is_connected():
            self.client.disconnect()
        self.connect()
    except Exception as e:
        self.main_log.error(f"重连失败: {traceback.format_exc()}")
        raise custom_exceptions.UnableToConnect()

5. 调整PyInstaller打包参数（若使用无窗口模式） #

如果打包时用了--noconsole参数，先尝试移除该参数测试：

pyinstaller --console --hidden-import ... your_script.py

无窗口模式可能干扰opcua的线程IO处理，确认通信正常后再通过其他方式实现无窗口运行。

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