TEXTURE_MIN_FILTER非NEAREST时黑屏，Mipmap与TEXTURE_WRAP_S异常求助

一、Mipmap过滤模式导致黑屏的原因及修复 #

当你使用gl.NEAREST_MIPMAP_NEAREST、gl.LINEAR_MIPMAP_NEAREST等带MIPMAP的MIN_FILTER选项时，WebGL要求纹理必须拥有完整的mipmap层级链。如果未生成mipmap，纹理会被标记为"不完全"状态，此时采样纹理会返回纯黑色。

你的代码中缺少生成mipmap的关键步骤，需要在绑定纹理、上传纹理数据（比如gl.texImage2D）并设置完纹理参数后，调用gl.generateMipmap(gl.TEXTURE_2D)。

修改后的核心代码片段：

world.GL.gl.activeTexture(world.GL.gl['TEXTURE' + t]);
world.GL.gl.bindTexture(world.GL.gl.TEXTURE_2D, object.textures[t]);
world.GL.gl.pixelStorei(world.GL.gl.UNPACK_FLIP_Y_WEBGL, false);

// 先完成纹理数据上传（比如gl.texImage2D，这一步你可能遗漏了）

// 设置纹理参数
if (world.GL.extTFAnisotropic) {
    world.GL.gl.texParameterf(world.GL.gl.TEXTURE_2D,
      world.GL.extTFAnisotropic.TEXTURE_MAX_ANISOTROPY_EXT,
      world.GL.MAX_TEXTURE_MAX_ANISOTROPY_EXT);
}

world.GL.gl.texParameteri(world.GL.gl.TEXTURE_2D, world.GL.gl.TEXTURE_MAG_FILTER, object.texParams.TEXTURE_MAG_FILTER | world.GL.gl.LINEAR);
world.GL.gl.texParameteri(world.GL.gl.TEXTURE_2D, world.GL.gl.TEXTURE_MIN_FILTER, object.texParams.TEXTURE_MIN_FILTER | world.GL.gl.LINEAR);
world.GL.gl.texParameteri(world.GL.gl.TEXTURE_2D, world.GL.gl.TEXTURE_WRAP_S, object.texParams.TEXTURE_WRAP_S | world.GL.gl.REPEAT);
world.GL.gl.texParameteri(world.GL.gl.TEXTURE_2D, world.GL.gl.TEXTURE_WRAP_T, object.texParams.TEXTURE_WRAP_T | world.GL.gl.REPEAT);

// 生成mipmap，必须在纹理数据上传和参数设置完成后调用
world.GL.gl.generateMipmap(world.GL.gl.TEXTURE_2D);

world.GL.gl.uniform1i(object.shaderProgram.samplerUniform, t);

二、Generate Mipmap后TEXTURE_WRAP_S失效的原因及修复 #

WebGL默认规则：使用REPEAT等包装模式时，纹理的宽高必须是2的幂次方（如128、256、512）。如果纹理尺寸不符合要求，即使手动设置了REPEAT，WebGL会自动将包装模式降级为CLAMP_TO_EDGE，导致看起来"失效"。

解决方式有两种：

1. 调整纹理尺寸为2的幂次方：这是最稳妥的方案，完全符合WebGL标准行为，无兼容性风险。
2. 启用非2幂纹理扩展：若无法修改纹理尺寸，可尝试启用OES_texture_non_power_of_two扩展，但需注意：
   • 部分设备/浏览器可能不支持该扩展；
   • 即使启用，mipmap与REPEAT的组合在部分环境下仍可能无法正常工作。
   • 启用扩展代码示例：

     const ext = world.GL.gl.getExtension('OES_texture_non_power_of_two');
     if (!ext) {
         console.warn('当前设备不支持非2幂纹理扩展');
     }
     

另外，确保在生成mipmap之前设置好WRAP参数，避免参数顺序导致的异常。

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