远程调试树莓派C++嵌入Python程序时PyModule_GetDict触发段错误排查

我之前也碰到过类似的场景，用Visual Studio远程调试树莓派（Raspbian）上的C++嵌入Python程序，刚好也是PyModule_GetDict触发段错误，结合你的情况，给你梳理几个最可能的原因和解决办法：

先明确你的问题场景：你在树莓派上的C++应用通过Python/C API嵌入了Python脚本，调用PyModule_GetDict(pModule)时出现段错误，错误信息是：

Program received signal SIGSEGV, Segmentation fault. 0x76bfdd28 in PyModule_GetDict () from /usr/lib/arm-linux-gnueab...

最可能的错误原因及排查步骤 #

• pModule是空指针
  这是最常见的元凶！你得先确认加载Python模块的函数（比如PyImport_ImportModule或者PyImport_AddModule）有没有成功返回。Python/C API的很多函数在出错时会返回NULL，比如模块找不到、脚本有语法错误，这时候直接调用PyModule_GetDict就是在解引用空指针，必然崩溃。

  建议你在获取模块后立刻加检查，同时打印Python的错误信息，这能帮你快速找到模块加载失败的原因：

  PyObject* pModule = PyImport_ImportModule("你的脚本模块名");
  if (pModule == NULL) {
      PyErr_Print(); // 这一步一定要加，会输出Python层面的错误详情
      return -1;
  }
  

• Python解释器没正确初始化
  在调用任何Python/C API函数之前，必须确保已经执行了Py_Initialize()，而且初始化成功。如果跳过这一步，或者初始化过程中出了问题，后续所有API调用都会乱套，包括获取模块字典。

  要是你的程序是多线程环境，还得记得调用PyEval_InitThreads()来初始化线程支持，否则跨线程调用API也可能触发奇怪的内存错误。

• pModule不是合法的模块对象
  PyModule_GetDict要求传入的必须是标准的Python模块对象，如果pModule指向的是其他类型的PyObject（比如字符串、列表），调用这个函数也会直接崩溃。你可以用PyModule_Check来验证：

  if (!PyModule_Check(pModule)) {
      printf("警告：pModule不是有效的模块对象！\n");
      Py_DECREF(pModule);
      return -1;
  }
  

• Python库版本不匹配
  如果你本地编译C++程序时链接的Python库版本，和树莓派上安装的Python版本不一致，也可能导致这种段错误。比如你本地用Python3.9编译，树莓派上装的是Python3.7，这种版本不兼容会让API调用的内存布局出错。

  你可以在树莓派上用python3 --version查看版本，编译时确保链接对应的库（比如-lpython3.7m）。

• 引用计数错误导致模块对象被提前释放
  有没有在调用PyModule_GetDict之前，不小心调用了Py_DECREF(pModule)？这会让模块对象的引用计数减到0，被Python的垃圾回收机制销毁，pModule就变成了野指针，访问它的字典自然会崩溃。一定要严格遵守Python/C API的引用计数规则，不要随便释放还在使用的对象。

调试小技巧 #

在Visual Studio远程调试时，你可以给pModule设个监视断点，看看它的地址是不是0（空指针），或者有没有异常的内存值。另外，一定要用上PyErr_Print()，很多时候模块加载失败的原因（比如脚本路径不对、语法错误）都能通过这个函数打印出来，比单纯看段错误信息有用多了。

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