Python2转Python3 C扩展报错：Type未定义tp_name字段

可能的原因及修复步骤 #

1. 规范tp_name的定义格式与位置 #

Python3要求类型对象的tp_name必须是静态常量字符串，且需严格遵循模块名.类型名的命名规范，要和你的导入路径完全匹配。比如你的场景中，应该写成"tentacle_pi.AM2315"，而非单纯的"AM2315"。

正确示例：

static PyTypeObject AM2315Type = {
    PyVarObject_HEAD_INIT(NULL, 0)
    .tp_name = "tentacle_pi.AM2315",  // 对应导入时的路径
    .tp_basicsize = sizeof(AM2315Object),
    // 其他类型字段...
};

2. 修正类型对象的初始化流程 #

Python3废弃了PyType_Init，必须在模块初始化时调用PyType_Ready()完成类型准备，同时要检查返回值确保初始化成功：

static struct PyModuleDef am2315module = {
    PyModuleDef_HEAD_INIT,
    .m_name = "tentacle_pi.AM2315",
    .m_doc = "AM2315 sensor driver",
    .m_size = -1,
};

PyMODINIT_FUNC PyInit_AM2315(void) {
    PyObject *m;
    // 先完成类型对象的初始化
    if (PyType_Ready(&AM2315Type) < 0)
        return NULL;

    m = PyModule_Create(&am2315module);
    if (m == NULL)
        return NULL;

    Py_INCREF(&AM2315Type);
    PyModule_AddObject(m, "AM2315", (PyObject *)&AM2315Type);
    return m;
}

3. 补充Python3要求的必填字段 #

Python3对PyTypeObject的字段完整性要求更高，必须设置tp_flags字段，至少包含Py_TPFLAGS_DEFAULT：

.tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,

缺少该字段会导致解释器无法识别类型合法性，间接触发tp_name相关错误。

4. 清理缓存后重新编译安装 #

旧的Python2编译残留可能干扰Python3构建，执行以下命令清理后重新安装：

rm -rf build/ dist/ *.egg-info
python3 setup.py clean --all
python3 setup.py install

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