GLES2移动端开发FBO帧缓冲深度渲染异常问题求助

你碰到的深度渲染异常、深度纹理纯黑是GLES2移动端开发的典型兼容坑，直接触发原因有三个：

• 现有代码把深度纹理创建、FBO深度附件挂载的逻辑全注释了，当前FBO根本没有深度存储介质，绘制时不会写入任何深度值，必然出现深度穿插错误
• 你参考的深度纹理写法不符合GLES2规范：GL_DEPTH_COMPONENT+GL_UNSIGNED_BYTE的格式组合在绝大多数移动端GPU上不被支持，就算取消注释，深度附件也会创建失败，渲染出来自然是纯黑
• 缺少FBO状态校验和绘制阶段的状态配置，就算附件创建正确，也会因为没开深度测试、没清除深度缓冲导致深度逻辑不生效

1. 修正深度附件创建参数 #

GLES2的深度纹理遵循GL_OES_depth_texture扩展规范，必须使用指定的格式和包裹模式：

// 初始化阶段先检查扩展支持，2012年后的移动端设备基本全支持，但必须加校验
const char* extStr = (const char*)glGetString(GL_EXTENSIONS);
bool supportDepthTex = strstr(extStr, "GL_OES_depth_texture") != nullptr;

glGenTextures(1, &FBO_depth);
glBindTexture(GL_TEXTURE_2D, FBO_depth);
// 深度纹理不支持GL_REPEAT包裹模式，必须用CLAMP_TO_EDGE，否则会直接渲染黑色
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
// 核心修正：内部格式用GL_DEPTH_COMPONENT16，数据类型用GL_UNSIGNED_SHORT，这是GLES2通用兼容格式
glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT16, 600, 600, 0, GL_DEPTH_COMPONENT, GL_UNSIGNED_SHORT, NULL);
glBindTexture(GL_TEXTURE_2D, 0);

如果你不需要采样深度值、只需要FBO能正常做深度测试，直接用深度渲染缓冲（RBO）代替深度纹理即可，不需要依赖扩展，兼容性100%：

GLuint depthRBO;
glGenRenderbuffers(1, &depthRBO);
glBindRenderbuffer(GL_RENDERBUFFER, depthRBO);
glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT16, 600, 600);
glBindRenderbuffer(GL_RENDERBUFFER, 0);

2. 补全FBO挂载与完整性校验 #

取消深度附件的注释，挂载完成后必须检查FBO状态，避免静默失败：

glGenFramebuffers(1, &FBO);
glBindFramebuffer(GL_FRAMEBUFFER, FBO);

glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, FBO_Texture, 0);
// 挂载深度纹理，如果你用RBO就替换成对应的Renderbuffer挂载接口
glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, FBO_depth, 0);
// RBO挂载写法：glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, depthRBO);

// 必须加FBO状态校验，出错时直接打日志定位
GLenum fboStatus = glCheckFramebufferStatus(GL_FRAMEBUFFER);
if (fboStatus != GL_FRAMEBUFFER_COMPLETE) {
    // 常见错误码：GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT（附件格式不支持）、GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS（附件尺寸不匹配）
    printf("FBO init error, status = 0x%x\n", fboStatus);
}

glBindFramebuffer(GL_FRAMEBUFFER, 0);

3. 修正FBO绘制时的状态配置 #

GLES2不会在切换FBO时自动继承默认帧缓冲的状态，每次绑定FBO后必须显式配置：

glBindFramebuffer(GL_FRAMEBUFFER, FBO);
// 视口尺寸必须和FBO附件尺寸完全一致，否则会出现绘制拉伸、深度值对齐错误
glViewport(0, 0, 600, 600);
// 显式开启深度测试，打开深度写入掩码
glEnable(GL_DEPTH_TEST);
glDepthFunc(GL_LESS);
glDepthMask(GL_TRUE);
// 清除缓冲时必须带上GL_DEPTH_BUFFER_BIT，否则旧深度值会残留
glClearColor(0.0f, 0.0f, 0.0f, 1.0f);
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);

// 这里执行你的FBO绘制逻辑
// ...

// 绘制完成切回默认帧缓冲
glBindFramebuffer(GL_FRAMEBUFFER, 0);
// 记得切回默认帧缓冲后把视口重置为屏幕实际尺寸
glViewport(0, 0, screenWidth, screenHeight);

如果上述修改后仍有问题，逐一核对：

• 片元着色器中不要手动写gl_FragDepth，GLES2默认不支持自定义深度值，开启对应扩展才可以使用，强行写入会导致深度附件写入失败
• 确认绘制过程中没有调用glDisable(GL_DEPTH_TEST)或者glDepthMask(GL_FALSE)，这两个接口会直接关闭深度写入
• 采样深度纹理时，GLES2下普通深度值读取用sampler2D即可，做阴影比较时才需要用sampler2DShadow，类型错了会采样到全0（纯黑）
• 确认颜色纹理和深度纹理的宽高完全一致，尺寸不匹配会直接导致FBO创建失败

内容的提问来源于stack exchange，提问作者José Antônio