Qt-CDB设置PYTHONPATH后崩溃：boost::python嵌入Python调试异常

我之前也碰到过类似的boost::python嵌入调试崩溃的情况，尤其是修改PYTHONPATH环境变量之后，结合你给出的调试器错误信息，给你几个实用的排查和解决方向：

The CDB process terminated Debugger output ERROR: Process crashed dCDB PROCESS FINISHED, status 1, exit code -1073740791 dNOTE: ENGINE ILL ****** dState changed from EngineSetupRequested(1) to EngineShutdownRequested(19) [master] dCALL: SHUTDOWN ENGINE dNOTE: ENGINE SHUTDOWN OK dState changed from EngineShutdownRequested(19) to EngineShutdownOk(21) [mas...

1. 排查PYTHONPATH路径下的模块兼容性 #

当你设置PYTHONPATH后，Python解释器会优先从这个路径加载模块。如果路径里存在：

• 和当前嵌入环境Python版本不匹配的扩展模块（比如你用Python 3.8编译的程序，但PYTHONPATH里有Python 3.10的.pyd文件）
• 损坏或不完整的模块文件
  都可能触发崩溃。

解决步骤：

• 先把PYTHONPATH临时设置为一个空的测试文件夹，重新启动调试，看是否还会崩溃。
• 如果恢复正常，再逐步添加原来的PYTHONPATH路径，逐个排查是哪个路径下的模块导致了问题。

2. 确保调试器与Python架构一致 #

CDB调试器的架构（32位/64位）必须和你嵌入的Python解释器完全匹配。如果PYTHONPATH引入了不同架构的模块，或者调试器本身架构不对，也会出现这种崩溃。

验证方法：
运行以下Python代码检查架构：

import sys
print(sys.maxsize > 2**32)  # True表示64位，False表示32位

然后确保你使用的CDB是对应架构的版本（比如64位Python就用x64版的CDB）。

3. 检查boost::python的链接方式 #

如果你的程序是动态链接Python和boost::python库，设置PYTHONPATH后可能意外加载了系统中另一个版本的Python库，和编译时依赖的版本不兼容，导致崩溃。

解决建议：

• 尝试改为静态链接Python和boost::python，避免运行时加载其他版本的库。
• 或者在程序启动时，通过Py_SetPythonHome明确指定Python的安装路径，强制解释器使用指定版本的库，不受PYTHONPATH干扰。

4. 修复调试器符号加载问题 #

调试器崩溃也可能是因为无法正确加载Python或boost::python的符号文件（.pdb），导致崩溃时无法处理异常。

操作步骤：

• 在CDB中手动设置符号路径：

.sympath+ "C:\path\to\python\symbols;C:\path\to\boost\symbols"

• 确保你使用的Python和boost::python库带有对应的符号文件（编译时选择Debug模式或下载符号包）。

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