如何在PyQt5工作线程中运行simple_pjsua.py？

问题根源 #

pjlib要求所有调用其API的线程必须先完成线程注册，PyQt工作线程是独立于主线程的执行上下文，你之前单独运行时在主线程完成了注册，但工作线程未执行该步骤，导致触发断言检查失败。

具体解决步骤 #

• 确保共享库导出线程注册/注销函数
  交叉编译PJSIP共享库时，需确保pj_thread_register()和pj_thread_unregister()函数被导出。可通过编译时添加EXPORT_ALL_SYMBOLS（针对CMake）或手动指定导出符号表的方式实现，避免函数被隐藏。

• 在工作线程启动时注册pjlib线程
  在PyQt工作线程的run()方法开头，先调用ctypes封装的线程注册函数，完成后再执行PJSIP相关逻辑，示例代码如下：

  from PyQt5 import QtCore
  from ctypes import CDLL, c_char_p, c_void_p, c_int
  
  # 加载编译好的PJSIP共享库
  pjsua_lib = CDLL("./libsimple_pjsua.so")
  
  # 声明pj_thread_register的函数原型（匹配C接口）
  pjsua_lib.pj_thread_register.argtypes = [c_void_p, c_char_p, c_void_p, c_void_p]
  pjsua_lib.pj_thread_register.restype = c_int
  # 声明注销函数
  pjsua_lib.pj_thread_unregister.restype = c_int
  
  class PJSIPWorker(QtCore.QThread):
      def run(self):
          # 注册当前工作线程到pjlib
          reg_status = pjsua_lib.pj_thread_register(None, b"PJSIP_Worker_Thread", None, None)
          if reg_status != 0:
              print(f"pjlib线程注册失败，状态码: {reg_status}")
              return
  
          # 执行你的PJSIP业务逻辑（初始化、账号注册、呼叫等）
          self._execute_pjsua_logic()
  
          # 线程结束前注销（推荐，避免资源泄漏）
          pjsua_lib.pj_thread_unregister()
  
      def _execute_pjsua_logic(self):
          # 这里写你原来的PJSIP封装调用代码
          pass
  

• 统一PJSIP操作的线程上下文
  所有PJSIP相关操作（初始化、API调用、资源销毁）必须在同一个已注册的线程中执行，禁止跨线程调用pjlib API——pjlib内部很多状态结构是线程绑定的，跨线程会导致不可预期的错误。

• 处理UI更新的线程安全问题
  如果PJSIP回调需要更新PyQt UI，必须通过PyQt的信号-槽机制，在回调中发射信号，由主线程的槽函数处理UI操作，避免直接在工作线程（或PJSIP回调线程）中操作UI控件。

• 通过断言信息精准排查
  若问题仍存在，打印断言错误的具体内容（如assertion "thread != NULL" failed），可快速定位是注册参数错误、函数未导出还是线程上下文不匹配的问题。

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