Python C扩展链接报错：symbol多次定义问题求助

问题根源 #

__attribute__((visibility("hidden")))仅控制符号在最终共享库中的对外可见性，无法解决多个编译单元（.o文件）中重复定义全局符号的问题。只要同一个全局符号（比如你的自定义PyTypeObject）在多个.c文件中被定义，链接器合并目标文件时就会触发"multiple definition"错误——visibility属性不影响编译阶段的符号定义，只影响最终库的符号导出。

正确解决方案 #

1. 严格分离声明与定义 #

将自定义类型的声明放在头文件中，仅在一个实现文件中完成定义：

头文件（如myobject.h）

#ifndef MYOBJECT_H
#define MYOBJECT_H

#include <Python.h>

// 用extern声明类型，同时添加hidden属性
extern __attribute__((visibility("hidden"))) PyTypeObject MyObject_Type;

#endif

主实现文件（如myobject.c）

#include "myobject.h"

// 仅在此处定义类型对象，添加hidden属性
__attribute__((visibility("hidden"))) PyTypeObject MyObject_Type = {
    PyVarObject_HEAD_INIT(NULL, 0)
    .tp_name = "mymodule.MyObject",
    .tp_basicsize = sizeof(MyObject),
    .tp_flags = Py_TPFLAGS_DEFAULT,
    // 其他类型字段定义...
};

其他依赖文件（如utils.c）

#include "myobject.h"

// 直接使用extern声明的MyObject_Type，无需重复定义
static PyObject* create_myobject(PyObject* self, PyObject* args) {
    return PyObject_New(&MyObject_Type, NULL);
}

2. 全局开启编译可见性控制 #

在编译时全局添加-fvisibility=hidden选项，避免遗漏单个符号的属性设置，同时符合Python C API的规范要求。在setup.py中配置：

from setuptools import setup, Extension

extension = Extension(
    "mymodule",
    sources=["myobject.c", "utils.c"],
    extra_compile_args=["-fvisibility=hidden"],
)

setup(
    name="mymodule",
    version="0.1",
    ext_modules=[extension]
)

3. 排查重复定义 #

用nm命令检查每个目标文件的符号状态，确认仅一个.o文件包含类型对象的定义：

# 查看符号类型：D=已定义，U=未定义（引用）
nm -C myobject.o | grep MyObject_Type
nm -C utils.o | grep MyObject_Type

如果多个.o文件显示D标记，说明存在重复定义，需要删除多余的类型定义代码。

验证方法 #

执行python setup.py build_ext --inplace重新编译，若链接错误消失，且用objdump -x mymodule.cpython-310-x86_64-linux-gnu.so | grep MyObject_Type看不到该符号（因为hidden属性），则配置正确。

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