Panda3D重运行触发多ShowBase实例异常的解决方案

你的代码本身没有编写错误，触发该异常的核心逻辑是：
Panda3D的ShowBase采用全局单例设计，手动关闭渲染窗口时只会销毁图形界面的窗口资源，不会清空当前Python进程内存中留存的ShowBase全局引用标记。而Spyder默认在同一个持久化IPython内核中反复运行脚本，不会每次执行都重启全新Python进程，因此第二次启动代码实例化继承自ShowBase的World类时，内核中还残留着上一次运行的ShowBase实例标记，就会抛出 "Exception: Attempt to spawn multiple ShowBase instances" 异常。

以下方案均适配Panda3D 1.10.x正式版本，不需要重启控制台内核即可重复运行代码：

• 方案1：实例化前主动清理残留全局对象
  不需要改动原有业务逻辑，只需要把代码末尾实例化启动的部分替换为如下写法，创建新实例前先检测并清理已存在的ShowBase残留：

  import builtins
  # 其余原有导入、loadPrcFile配置、World类定义完全保持不变
  
  if __name__ == '__main__':
      # 清理已存在的ShowBase实例
      if 'base' in dir(builtins):
          base.destroy()
          del builtins.base
      app = World()
      app.run()
  

  这是侵入性最低的方案，不需要调整Spyder配置，关闭窗口后直接重跑脚本即可正常启动新实例。
• 方案2：修改Spyder运行配置
  如果不想改动业务代码，可以直接调整Spyder的运行规则，让每次脚本运行都启动独立的全新进程：
  打开Spyder设置 -> 运行 -> 通用设置，勾选 "在新的专用Python控制台中执行"，保存配置后每次运行脚本都会启动独立Python环境，不会留存上一次运行的ShowBase实例，从根源上避免单例冲突。缺点是每次启动新进程会增加数秒的环境加载时间。
• 方案3：绑定窗口退出时自动清理逻辑
  可以在World类的初始化方法中添加退出回调，在手动关闭渲染窗口时就自动完成实例和全局引用的清理，不需要等到下次运行脚本时再处理：

  class World(ShowBase):
      def __init__(self):
          ShowBase.__init__(self)
          # 绑定退出清理回调
          self.exitFunc = self._cleanup
          # 其余原有simplepbr初始化、模型加载、灯光配置等逻辑保持不变
  
      def _cleanup(self):
          self.destroy()
          import builtins
          if hasattr(builtins, 'base'):
              del builtins.base
      
      # 原有spinCameraTask等方法保持不变
  

• 如果你使用了simplepbr、物理引擎、自定义全局渲染管线这类附加模块，清理实例时如果遇到残留引用报错，可以在调用destroy()前手动移除你自己挂载到taskMgr、render节点上的自定义任务和场景节点，避免隐性内存泄漏。
• 网上流传的直接修改ShowBase单例校验标记、跳过实例数检查的方法不要使用，这类方案会导致渲染上下文崩溃、显存泄漏等不可预知的问题，在较新版本的Panda3D中也已经失效。

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