LibGDX中ModelBuilder end()异常及立方体渲染问题求助

让我一步步拆解你的问题和遇到的坑：

1. 为什么会抛出Call end() first异常？ #

从你的代码来看，modelBuilder.begin() → createBox() → modelBuilder.end()的调用顺序是完全正确的，理论上不该出现这个异常。大概率是调试过程中误操作导致的重复构建会话冲突——比如你可能在测试时多次调用了begin()但没对应调用end()，或者modelBuilder的lazy初始化逻辑意外触发了多次初始化，导致前一个构建周期还未结束就启动了新的。不过从最终解决后的代码来看，这个异常应该是排查过程中的临时问题，而非核心渲染失败的原因。

2. 使用modelBuilder.begin()和end()是不是最佳实践？ #

这要分场景来看：

• 单个简单模型：如果只是创建单个立方体、球体这类独立模型，完全可以直接用ModelBuilder的静态创建方法（比如createBox()的无begin/end版本），旧示例大多用这种写法，代码更简洁直观。
• 多形状组合模型：如果你需要把多个形状（比如立方体+圆柱体）合并到同一个Model对象里，就必须用begin()启动构建会话，逐个添加形状后用end()完成构建——这时候这两个方法就是官方推荐的最佳实践，能有效减少渲染批次，提升性能。

你的核心问题：立方体不显示的根源 #

你最终发现的clearScreen()问题才是渲染失败的关键：KTX的clearScreen()默认只清除颜色缓冲区，没有清除深度缓冲区。这意味着后续渲染的立方体因为深度测试失败，被之前帧的深度数据遮挡，所以无法显示在屏幕上。

解决方法很简单，在render()里手动补充深度缓冲区的清除：

override fun render(delta: Float) {
    Gdx.gl.glViewport(0, 0, baseUI.aWidth.toInt(), baseUI.aHeight.toInt())
    // 同时清除颜色和深度缓冲区
    Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT or GL20.GL_DEPTH_BUFFER_BIT)
    
    modelBatch.begin(cam)
    modelBatch.render(boxInstance, environment)
    modelBatch.end()
}

或者如果你想保留clearScreen()的用法，可以这样组合：

clearScreen(.3f, .3f, .3f, 1f)
// 额外清除深度缓冲区
Gdx.gl.glClear(GL20.GL_DEPTH_BUFFER_BIT)

小优化建议 #

既然你只是创建单个立方体，完全可以简化模型创建代码，去掉手动的begin()/end()：

// 替换init块里的模型创建逻辑
boxInstance = ModelInstance(
    modelBuilder.createBox(
        5f, 5f, 5f,
        greenMat,
        vertexAttributes
    )
)

这样既避免了构建会话管理的潜在问题，代码也更简洁。

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