PyOpenGL中glGenVertexArrays在线程中触发段错误的问题排查

我用Python的PyOpenGL开发简易Minecraft仿作，主线程更新世界几何太耗时，于是用threading开线程处理。之前glGenVertexArrays()在主线程正常运行，但线程调用后触发Segmentation fault (core dumped)错误，定位到Mesh类__init__方法里的self.vao = glGenVertexArrays(1)这一行，该方法由线程调用生成新区块的几何结构。

线程代码：

def update(self): ## Just to make new chunks and set their visibility based on player position 
    global RUNNING
    while RUNNING == True:
        time.sleep(0.1)
        player_chunk_pos = self.player.position.tolist()
        player_chunk_pos = [int(player_chunk_pos[0] // (Chunk.size[0] * Block.size)), int(player_chunk_pos[2] // (Chunk.size[1] * Block.size))]
        if player_chunk_pos != self.player.chunk_pos:
            print("Changed Chunks")
            self.player.chunk_pos = player_chunk_pos
            print("Passed 1")
            self.make_or_use() ## method that calls the __init__() method

Mesh类初始化代码：

def __init__(self, verticies):

    self.verticies = verticies

    self.vertex_count = len(self.verticies) // 8 # find the number of vertexes. 8 is the number of attributes in the dataset

    self.verticies = np.array(self.verticies, dtype=np.float32)

    self.vao = glGenVertexArrays(1) #### * THIS LINE ############

    glBindVertexArray(self.vao)
    self.vbo = glGenBuffers(1) 
    glBindBuffer(GL_ARRAY_BUFFER, self.vbo)  
    glBufferData(GL_ARRAY_BUFFER, self.verticies.nbytes, self.verticies, GL_STATIC_DRAW) 

    glEnableVertexAttribArray(0)
    glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 32, ctypes.c_void_p(0))

    glEnableVertexAttribArray(1)
    glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 32, ctypes.c_void_p(12))

    glEnableVertexAttribArray(2)
    glVertexAttribPointer(2, 3, GL_FLOAT, GL_FALSE, 32, ctypes.c_void_p(20))

OpenGL上下文是线程绑定的——所有OpenGL操作必须在创建该上下文的线程（也就是你的主线程）中执行。子线程没有有效的OpenGL上下文，直接调用glGenVertexArrays()等GPU交互API会导致内存访问错误，触发段错误。

核心思路是子线程只负责生成几何数据，主线程处理OpenGL资源创建，具体步骤如下：

1. 拆分任务流程

   • 子线程仅执行区块逻辑计算、生成顶点数据（verticies列表），不调用Mesh的__init__方法。
   • 把生成好的顶点数据放入线程安全队列（如queue.Queue），等待主线程处理。

2. 主线程处理OpenGL操作

   • 在主线程的渲染循环中，定期检查队列是否有新数据。
   • 一旦有新数据，在主线程中创建Mesh对象（此时所有OpenGL调用都在有效上下文内执行，不会出错）。

示例代码修改：

首先初始化线程安全队列：

import queue

# 定义线程安全队列，用于传递顶点数据
chunk_data_queue = queue.Queue()

修改子线程的update方法：

def update(self):
    global RUNNING
    while RUNNING == True:
        time.sleep(0.1)
        player_chunk_pos = self.player.position.tolist()
        player_chunk_pos = [int(player_chunk_pos[0] // (Chunk.size[0] * Block.size)), int(player_chunk_pos[2] // (Chunk.size[1] * Block.size))]
        if player_chunk_pos != self.player.chunk_pos:
            print("Changed Chunks")
            self.player.chunk_pos = player_chunk_pos
            print("Passed 1")
            # 仅生成顶点数据，不创建Mesh
            verticies = self.generate_chunk_verticies() # 替换为你生成顶点的实际函数
            chunk_data_queue.put(verticies) # 将数据放入队列

主线程渲染循环中处理队列：

# 主线程渲染循环内
while RUNNING:
    # 处理队列中的新顶点数据
    while not chunk_data_queue.empty():
        verticies = chunk_data_queue.get()
        new_mesh = Mesh(verticies) # 在主线程创建Mesh，执行OpenGL调用
        self.scene_meshes.append(new_mesh) # 将新Mesh加入场景
    
    # 常规渲染逻辑
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
    # ... 绘制所有场景中的Mesh ...
    pygame.display.flip()

3. 额外注意事项
   • 若顶点数据生成耗时，子线程可并行处理多个区块的计算，主线程仅负责GPU资源创建，既利用多核CPU，又遵守OpenGL线程规则。
   • queue.Queue本身是线程安全的，无需额外加锁。

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