使用PyLong_FromLong转换C中小整数至Python时崩溃的解决方法

你遇到的段错误核心原因有两个：

1. GIL 未持有：ctypes 默认在释放全局解释器锁（GIL）的状态下调用动态库函数，而几乎所有 Python C API 调用都要求在持有 GIL 的环境中执行。小整数池（-5~256）的对象是全局共享的，无 GIL 访问会直接触发内存非法访问。
2. 动态库未链接 Python 运行时：普通编译的动态库没有关联 Python 的共享库，导致调用 PyLong_FromLong 时无法正确访问 Python 的内部数据结构。

1. 修改 C 代码，添加 GIL 管理 #

必须在调用 Python C API 前后获取和释放 GIL，确保线程环境正确：

#include <Python.h>

PyObject* convert_long_to_pyobject(long lng)
{
    // 获取 GIL，确保当前线程可以安全调用 Python C API
    PyGILState_STATE gstate = PyGILState_Ensure();
    PyObject* result = PyLong_FromLong(lng);
    // 释放 GIL，恢复之前的线程状态
    PyGILState_Release(gstate);
    return result;
}

2. 编译时链接 Python 共享库 #

编译动态库时必须指定 Python 的头文件路径和链接库，确保动态库能正确关联 Python 运行时：

Linux/macOS 编译命令 #

# Linux
gcc -shared -fPIC -o mylib.so mylib.c -I/usr/include/python3.9 -lpython3.9

# macOS（以 Python 3.9 框架安装为例）
gcc -shared -fPIC -o mylib.dylib mylib.c -I/Library/Frameworks/Python.framework/Versions/3.9/include/python3.9 -L/Library/Frameworks/Python.framework/Versions/3.9/lib -lpython3.9

Windows 编译命令（MSVC） #

cl /LD mylib.c /I"C:\Python39\include" /link /LIBPATH:"C:\Python39\libs" python39.lib

3. Python 调用代码保持不变 #

你的原有 Python 调用逻辑无需修改，只要确保加载的是正确编译后的动态库即可：

from ctypes import CDLL, c_long, py_object
dk = CDLL("mylib.so")  # 替换为你的动态库实际路径

dk.convert_long_to_pyobject.argtypes = [c_long]
dk.convert_long_to_pyobject.restype = py_object

print(dk.convert_long_to_pyobject(256))  # 正常返回256
print(dk.convert_long_to_pyobject(-5))   # 正常返回-5

• Py_Initialize 无需调用：当前进程已经是 Python 运行环境，重复初始化会导致内部状态混乱，反而引发错误。
• 小整数池的特殊性：Python 对 -5~256 的整数做了全局缓存，无 GIL 访问这些共享对象会直接触发段错误，而大整数是临时创建的对象，偶然未触发崩溃，但本质上同样存在风险。

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