Python类中代码拆分至独立函数后触发段错误问题排查

开发者阿泽

2026-7-24

类代码拆分后触发Pangolin段错误的原因与排查方向

问题场景

在用Python结合Pangolin实现3D显示时，出现以下异常：

将所有初始化与渲染逻辑放在类的__init__方法中，程序可正常运行；
将代码拆分为viewerInit（初始化）和viewerRefresh（渲染循环）两个独立方法后，逻辑完全一致的代码触发段错误，崩溃点在pango.FinishFrame()，且鼠标悬停窗口时更容易触发。

可正常运行代码（SimpleDisplay5.py）

# SimpleDisplay5.py

import faulthandler
import pypangolin as pango
import OpenGL.GL as gl
import numpy as np
import time

class Display3D(object):

    def __init__(self):
        self.win = pango.CreateWindowAndBind('Pangolin Viewer', 640, 480)
        gl.glEnable(gl.GL_DEPTH_TEST)

        pm = pango.ProjectionMatrix(640, 480, 420, 420, 320, 240, 0.1, 1000)
        mv = pango.ModelViewLookAt(-0, 0.5, -3, 0, 0, 0, pango.AxisY)
        self.s_cam = pango.OpenGlRenderState(pm, mv)

        ui_width = 180

        handler = pango.Handler3D(self.s_cam)
        self.d_cam = (
            pango.CreateDisplay()
            .SetBounds(
                pango.Attach(0),
                pango.Attach(1),
                pango.Attach.Pix(ui_width),
                pango.Attach(1),
                -640.0 / 480.0,
            )
            .SetHandler(handler)
        )

        self.points = np.random.uniform(-1.0, 1.0, (100, 3)).astype(np.float32)

        gl.glPointSize(5)
        gl.glColor3f(1.0, 0.0, 0.0)  # red
        
        while not pango.ShouldQuit():
            gl.glClear(gl.GL_COLOR_BUFFER_BIT | gl.GL_DEPTH_BUFFER_BIT)

            self.d_cam.Activate(self.s_cam)

            pango.glDrawPoints(self.points)

            pango.FinishFrame()
        # end while
    # end function

# end class

def main():
    faulthandler.enable()

    np.set_printoptions(suppress=True)

    disp3d = Display3D()

    while True:
        time.sleep(0.5)
    # end while

# end function

if __name__ == "__main__":
    main()

触发段错误代码（SimpleDisplay6.py）

# SimpleDisplay6.py

import faulthandler
import pypangolin as pango
import OpenGL.GL as gl
import numpy as np
import time

class Display3D(object):

    def __init__(self):
        self.viewerInit()

        self.viewerRefresh()
    # end function

    def viewerInit(self):
        self.win = pango.CreateWindowAndBind('Pangolin Viewer', 640, 480)
        gl.glEnable(gl.GL_DEPTH_TEST)

        pm = pango.ProjectionMatrix(640, 480, 420, 420, 320, 240, 0.1, 1000)
        mv = pango.ModelViewLookAt(-0, 0.5, -3, 0, 0, 0, pango.AxisY)
        self.s_cam = pango.OpenGlRenderState(pm, mv)

        ui_width = 180

        handler = pango.Handler3D(self.s_cam)
        self.d_cam = (
            pango.CreateDisplay()
            .SetBounds(
                pango.Attach(0),
                pango.Attach(1),
                pango.Attach.Pix(ui_width),
                pango.Attach(1),
                -640.0 / 480.0,
            )
            .SetHandler(handler)
        )

        self.points = np.random.uniform(-1.0, 1.0, (100, 3)).astype(np.float32)

        gl.glPointSize(5)
        gl.glColor3f(1.0, 0.0, 0.0)  # red
    # end function

    def viewerRefresh(self):
        while not pango.ShouldQuit():
            gl.glClear(gl.GL_COLOR_BUFFER_BIT | gl.GL_DEPTH_BUFFER_BIT)

            self.d_cam.Activate(self.s_cam)

            pango.glDrawPoints(self.points)

            pango.FinishFrame()
        # end while
    # end function
# end class

def main():
    faulthandler.enable()

    np.set_printoptions(suppress=True)

    disp3d = Display3D()

    while True:
        time.sleep(0.5)
    # end while

# end function

if __name__ == "__main__":
    main()

崩溃终端输出

$ python3 SimpleDisplay6.py 
Fatal Python error: Segmentation fault

Current thread 0x00007f4384b05740 (most recent call first):
  File "SimpleDisplay6.py", line 54 in viewerRefresh
  File "SimpleDisplay6.py", line 14 in __init__
  File "SimpleDisplay6.py", line 64 in main
  File "SimpleDisplay6.py", line 73 in <module>
Segmentation fault (core dumped)

可能原因

C++对象生命周期不匹配
Pangolin是C库，Python绑定对临时对象的生命周期处理存在差异。拆分后的viewerInit方法中，局部对象（如handler = pango.Handler3D(self.s_cam)）在方法执行完毕后被Python垃圾回收销毁，但底层C组件仍在引用该对象，导致后续渲染时访问无效内存触发段错误。而在__init__中，这些局部对象的生命周期与类实例绑定，不会被提前回收。
OpenGL上下文作用域问题
OpenGL上下文与当前线程、调用栈作用域强相关。__init__中所有OpenGL操作（窗口创建、状态设置、渲染）在同一函数栈完成，上下文保持有效；拆分后viewerInit完成初始化返回，viewerRefresh执行时可能上下文绑定状态被意外修改，或相关资源在函数调用结束后被释放。
Python绑定引用计数缺陷
部分Pangolin对象的Python绑定未正确处理引用计数：当对象作为类属性时可正常保留，但在子方法中创建的临时对象，方法结束后引用计数归零，导致C++对象被析构，但后续代码仍在使用对应的Python包装器。

排查与修复方向

延长临时对象生命周期：将viewerInit中的局部对象（如handler）保存为类属性（self.handler = pango.Handler3D(self.s_cam)），避免被提前回收。示例修改如下：

def viewerInit(self):
    # ... 其他初始化代码 ...
    self.handler = pango.Handler3D(self.s_cam)
    self.d_cam = (
        pango.CreateDisplay()
        .SetBounds(...)
        .SetHandler(self.handler)
    )
    # ... 其他初始化代码 ...

验证OpenGL上下文有效性：在viewerRefresh渲染循环开头，调用gl.glGetIntegerv(gl.GL_CURRENT_CONTEXT)确认上下文是否有效，或尝试重新绑定窗口上下文。
底层调试定位：使用gdb加载Python进程和core dump文件，查看段错误的C++层调用栈；或编译带调试符号的Pangolin版本，进一步定位底层崩溃点。
确认线程模型兼容性：Pangolin窗口事件处理依赖主线程消息循环，确保渲染循环始终在主线程运行，避免线程切换导致的上下文异常。

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

Python类中代码拆分至独立函数后触发段错误问题排查

问题场景 #

可正常运行代码（SimpleDisplay5.py） #

触发段错误代码（SimpleDisplay6.py） #

崩溃终端输出 #

可能原因 #