解决pybind11绑定含虚类参数/返回值函数的编译与导入错误

核心问题分析 #

你遇到的两个错误本质上都是纯虚基类绑定方式不当导致的：

• 编译时的“抽象类无法实例化”：pybind11默认会尝试生成基类的实例化代码，但纯虚类本身不能被实例化
• 导入时的“未定义符号_ZTV1A”：纯虚基类的虚表未正确生成/导出，或者绑定代码未关联对应的派生类

分步绑定方案 #

1. 绑定纯虚基类A #

纯虚类不能按普通类绑定，必须明确告知pybind11它的实际实例是派生类A_2，同时禁用自动实例化逻辑：

py::class_<A, A_2, std::unique_ptr<A, py::nodelete>>(m, "A")
    // 仅绑定A的虚函数声明，无需实现（派生类已完成实现）
    .def("do_something", &A::do_something);

关键细节：

• 模板参数添加A_2：让pybind11知晓A的实例均为A_2类型
• 使用std::unique_ptr<A, py::nodelete>：避免pybind11尝试删除抽象类对象
• 绝对不能添加.def(py::init<>())：纯虚类不允许被构造

2. 绑定派生类A_2 #

派生类按常规方式绑定，需明确关联基类A：

py::class_<A_2, A>(m, "A_2")
    .def(py::init<>())
    // 绑定A_2自身的成员函数，包括覆盖的纯虚函数
    ;

3. 绑定类B的somefunc方法 #

B的somefunc返回A*，需根据内存管理情况指定返回值策略：

py::class_<B>(m, "B")
    .def(py::init<>())
    // 若返回堆分配的新对象，用take_ownership让Python接管内存
    .def("somefunc", &B::somefunc, py::return_value_policy::take_ownership);

如果返回的是指向已存在对象的指针，替换为py::return_value_policy::reference即可。

4. 绑定类C的somefunc方法 #

C的方法接收A*参数，直接绑定即可，pybind11会自动处理派生类的向上转型：

py::class_<C>(m, "C")
    .def(py::init<>())
    .def("somefunc", &C::somefunc);

关键坑点修复 #

• 编译错误“抽象类无法实例化”：检查是否给A添加了py::init<>()，直接删除该语句；同时确保A的class_模板已关联派生类A_2。
• 链接错误“未定义符号_ZTV1A”：给纯虚基类A添加虚析构函数并在cpp文件中定义：

  // 头文件声明
  class A {
  public:
      virtual ~A() = 0;
      virtual void do_something() = 0;
  };
  // cpp文件定义
  A::~A() {}
  

  虚析构函数是生成虚表的必要条件，即使是纯虚析构也必须提供具体定义。

完整可运行示例 #

C++代码：

#include <pybind11/pybind11.h>

class A {
public:
    virtual ~A() = 0;
    virtual void do_something() = 0;
};

A::~A() {}

class A_2 : public A {
public:
    void do_something() override { /* 写入具体实现逻辑 */ }
};

class B {
public:
    A* somefunc() {
        return new A_2();
    }
};

class C {
public:
    void somefunc(A* a) {
        a->do_something();
    }
};

namespace py = pybind11;

PYBIND11_MODULE(example, m) {
    // 绑定纯虚基类A
    py::class_<A, A_2, std::unique_ptr<A, py::nodelete>>(m, "A")
        .def("do_something", &A::do_something);

    // 绑定派生类A_2
    py::class_<A_2, A>(m, "A_2")
        .def(py::init<>());

    // 绑定类B
    py::class_<B>(m, "B")
        .def(py::init<>())
        .def("somefunc", &B::somefunc, py::return_value_policy::take_ownership);

    // 绑定类C
    py::class_<C>(m, "C")
        .def(py::init<>())
        .def("somefunc", &C::somefunc);
}

Python调用示例：

import example

b = example.B()
a_instance = b.somefunc()
c = example.C()
c.somefunc(a_instance)

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