GtkTreeStore子类化后重载Linux插件时触发一系列GLib/GObject/Gtk断言错误

你遇到的这个问题是Linux下Gtk插件开发中非常典型的GObject类型系统冲突——第一次加载插件时，你的ProjectViewTreeStore类型已经被注册到主程序的全局GType系统里了，当你卸载插件后，动态库虽然被从内存中移除，但GType系统里的类型信息并不会被自动清理。第二次加载插件时，代码又尝试注册同一个类型，直接触发了一系列连锁断言错误。

错误链的根源 #

我们来拆解一下你看到的错误：

1. cannot register existing type 'ProjectViewTreeStore'：这是第一个错误，也是核心问题。GObject的类型系统是全局的，一旦某个类型被注册，就会一直存在于主程序的内存中，插件卸载不会主动清理它。第二次加载插件时，G_DEFINE_TYPE_WITH_CODE宏会再次尝试注册这个类型，自然触发冲突。
2. 后续的g_type_add_interface_static、g_once_init_leave_pointer、g_object_new_with_properties等断言错误，都是因为第一步类型注册失败，导致ProjectViewTreeStore类型无效，后续所有依赖这个类型的操作都无法正常执行。

解决方案：控制类型仅注册一次 #

要解决这个问题，我们需要手动接管类型注册逻辑，避免重复注册。具体步骤如下：

1. 替换自动生成的类型注册逻辑

原来的代码依赖G_DEFINE_TYPE_WITH_CODE宏自动完成类型注册，这个宏会在插件加载时自动执行，第二次加载就会重复注册。我们需要把它改成手动注册，并添加类型存在性检查。

修改你的源文件：

#include <gtk/gtk.h>
#include "project-view-tree-store.h"

struct _ProjectViewTreeStorePrivate {
    gboolean no_drag_first_row_;
};

// 静态变量保存已注册的类型，避免重复注册
static GType project_view_tree_store_type = 0;

static gboolean row_draggable(GtkTreeDragSource* drag_source, GtkTreePath* path);
static gboolean drag_data_get(GtkTreeDragSource* drag_source, GtkTreePath* path, GtkSelectionData* selection_data);
static gboolean drag_data_delete(GtkTreeDragSource* drag_source, GtkTreePath* path);
static void project_view_tree_store_dispose(GObject* object);
static void project_view_tree_store_finalize(GObject* object);

static void gtk_tree_drag_source_interface_init(GtkTreeDragSourceIface* iface) {
    iface->drag_data_delete = drag_data_delete;
    iface->drag_data_get = drag_data_get;
    iface->row_draggable = row_draggable;
}

// 手动实现类型注册函数，添加存在性检查
static void project_view_tree_store_register_type(void) {
    // 先检查类型是否已经存在
    if (g_type_from_name("ProjectViewTreeStore") != 0) {
        project_view_tree_store_type = g_type_from_name("ProjectViewTreeStore");
        return;
    }

    // 类型不存在，执行注册
    const GTypeInfo tree_store_type_info = {
        sizeof(ProjectViewTreeStoreClass),
        NULL, NULL,
        (GClassInitFunc)project_view_tree_store_class_init,
        NULL, NULL,
        sizeof(ProjectViewTreeStore),
        0,
        (GInstanceInitFunc)project_view_tree_store_init,
    };

    const GInterfaceInfo drag_source_iface_info = {
        (GInterfaceInitFunc)gtk_tree_drag_source_interface_init,
        NULL, NULL
    };

    project_view_tree_store_type = g_type_register_static(GTK_TYPE_TREE_STORE, 
                                                          "ProjectViewTreeStore", 
                                                          &tree_store_type_info, 
                                                          0);
    g_type_add_interface_static(project_view_tree_store_type, 
                                GTK_TYPE_TREE_DRAG_SOURCE, 
                                &drag_source_iface_info);
}

// 实现类型获取函数，确保注册只执行一次
GType project_view_tree_store_get_type(void) {
    if (project_view_tree_store_type == 0) {
        project_view_tree_store_register_type();
    }
    return project_view_tree_store_type;
}

static void project_view_tree_store_class_init(ProjectViewTreeStoreClass* klass) {
    printf("%s\n", __func__);
    GObjectClass* obj_class = G_OBJECT_CLASS(klass);
    obj_class->dispose = project_view_tree_store_dispose;
    obj_class->finalize = project_view_tree_store_finalize;
}

static void project_view_tree_store_init(ProjectViewTreeStore* self) {
    printf("%s\n", __func__);
    ProjectViewTreeStorePrivate* priv = project_view_tree_store_get_instance_private(self);
    self->priv = priv;
    self->priv->no_drag_first_row_ = FALSE;
}

// 其余函数保持不变...
ProjectViewTreeStore* project_view_tree_store_new(gint num_cols, GType* types) {
    printf("%s\n", __func__);
    ProjectViewTreeStore* store;
    store = g_object_new(PROJECT_VIEW_TYPE_TREE_STORE, NULL);
    gtk_tree_store_set_column_types(&store->parent_instance, num_cols, types);
    return store;
}

// 其余函数实现不变...

2. 确保插件初始化时触发类型检查

在你的插件入口初始化函数（比如plugin_init或者类似的函数）中，先调用类型获取函数，确保类型被正确注册（或复用已注册的类型）：

void plugin_init(void) {
    // 先触发类型注册/检查
    project_view_tree_store_get_type();
    // 其他插件初始化逻辑...
}

3. 头文件保持原有宏定义

你的头文件无需修改，因为PROJECT_VIEW_TYPE_TREE_STORE宏已经指向project_view_tree_store_get_type()，而我们已经修改了这个函数的实现，确保只注册一次。

额外注意事项 #

• 清理实例：插件卸载时，必须确保所有ProjectViewTreeStore的实例都被正确销毁（调用g_object_unref），避免内存泄漏。虽然GType不会被清理，但实例必须被正确释放。
• GTypeModule的可选优化：如果你的插件使用GTypeModule（推荐用于Gtk插件），可以用g_type_module_register_type代替g_type_register_static，这样类型会和模块绑定，模块卸载时类型会被标记为不可用，不过对于插件场景已经足够。

内容来源于stack exchange