自定义GLSL Shader流程正常但实体无法绘制，预期红色输出未生效

问题现象 #

应用自定义Shader执行图形渲染时，所有目标实体均未绘制输出，预期渲染结果为纯红色实体，实际表现与预期差异较大，问题定位困难。

现有实现代码 #

顶点着色器 #

#version 150

in vec2 attribute_position;

out vec3 v_color;

void main(void)
{
    gl_Position = vec4(attribute_position, 0.0, 1.0);
    
    v_color = vec3(1.0, 0.0, 0.0);
}

片段着色器 #

#version 150

in vec3 v_color;

out vec4 out_color;

void main(void)
{
    out_color = vec4(v_color, 1.0);
}

Shader加载类实现 #

public ShaderProgram(GL2 gl, String vertexShader, String fragmentShader) {
    vertexShaderId = loadShader(gl, vertexShader, GL2.GL_VERTEX_SHADER);
    fragmentShaderId = loadShader(gl, fragmentShader, GL2.GL_FRAGMENT_SHADER);
    
    programId = gl.glCreateProgram();
    gl.glAttachShader(programId, vertexShaderId);
    gl.glAttachShader(programId, fragmentShaderId);

    gl.glBindAttribLocation(programId, 0, "attribute_position");
    
    gl.glLinkProgram(programId);
    gl.glValidateProgram(programId);

    int[] status = new int[1];
    gl.glGetProgramiv(programId, GL2.GL_LINK_STATUS, status, 0);
    if (status[0] == GL2.GL_FALSE) {
        int[] error = new int[1];
        gl.glGetProgramiv(programId, GL2.GL_INFO_LOG_LENGTH, error, 0);

        byte[] log = new byte[error[0]];
        gl.glGetProgramInfoLog(programId, error[0], null, 0, log, 0);
        
        throw new RuntimeException("Error lniking the program: " + new String(log));
    }

    gl.glDetachShader(programId, vertexShaderId);
    gl.glDetachShader(programId, fragmentShaderId);
    gl.glDeleteShader(vertexShaderId);
    gl.glDeleteShader(fragmentShaderId);
}

private int loadShader(GL2 gl, String shader, int type) {
    int shaderId = -1;
    try {
        Scanner scanner = new Scanner(new File(shader), "UTF-8");
        String source = scanner.useDelimiter("\\A").next();
        scanner.close();
        
        if ((shaderId = gl.glCreateShader(type)) == GL2.GL_INVALID_ENUM) {
            System.out.println("error 1");
            System.exit(1);
        }
        
        gl.glShaderSource(shaderId, 1, new String[] { source }, new int[] { source.length() }, 0);
        gl.glCompileShader(shaderId);

        int[] status = new int[1];
        gl.glGetShaderiv(shaderId, GL2.GL_COMPILE_STATUS, status, 0);
        if (status[0] == GL2.GL_FALSE) {
            int[] error = new int[1];
            gl.glGetShaderiv(shaderId, GL2.GL_INFO_LOG_LENGTH, error, 0);

            byte[] log = new byte[error[0]];
            gl.glGetShaderInfoLog(shaderId, error[0], null, 0, log, 0);

            throw new RuntimeException("Error compiling the shader " + shader + ": " + new String(log));
        }    
    } catch (IOException exception) {
        System.out.println("error 3" + exception);
        System.exit(1);
    }

    return shaderId;
}

public void start(GL2 gl) {
    gl.glUseProgram(programId);
}

public void stop(GL2 gl) {
    gl.glUseProgram(0);
}

场景渲染逻辑 #

绘制前绑定Shader程序，绘制完成后解绑，代码如下：

if (shader == null)
    shader = new com.sandbox.StaticShader(graphics);
shader.start(graphics);
for (Layer layer : gameObjects.values()) {
    for (Component component : layer.objects) {
       if (component.isOpaque()) {
          component.render(graphics);
       }
     }
}
shader.stop(graphics);

高频问题排查方向 #

• 顶点属性配置异常：attribute_position虽被绑定到位置0，但需在链接完成后通过glGetAttribLocation确认实际绑定位置，若编译器优化移除了未使用的顶点属性会导致绑定失效；同时需确认实体渲染时是否向对应位置传入了正确的顶点坐标，且坐标值处于OpenGL裁剪空间[-1,1]区间内，超出范围的顶点会被直接裁剪。
• 程序验证状态未获取：代码中调用了glValidateProgram但未查询GL_VALIDATE_STATUS，验证失败时会直接导致渲染无输出，需补充该状态的查询与日志打印逻辑。
• VAO未绑定：OpenGL 3.2及以上核心模式下，必须绑定配置好顶点属性的顶点数组对象（VAO）才能执行渲染，当前代码片段未体现VAO绑定逻辑，若未绑定VAO会导致所有顶点属性输入为空，无渲染输出。
• Shader创建判断逻辑错误：glCreateShader调用失败时返回0，而非GL_INVALID_ENUM，当前的失败判断逻辑永远不会触发，若shader创建失败，会直接传入0作为shaderId执行后续编译流程，后续的编译错误捕获逻辑也无法正常生效。
• 渲染状态异常：需确认深度测试、裁剪测试、混合模式的配置是否正确，视口大小是否与窗口匹配，若深度值写入错误、裁剪区域配置为0、混合模式把颜色与背景完全抵消，都会出现无输出的情况。
• 链接日志未全量打印：当前仅在链接失败时打印错误日志，若链接成功但存在属性未被使用、varying变量不匹配的警告，也可能导致渲染异常，需在链接成功后主动打印程序信息日志。

内容的提问来源于stack exchange，提问作者Amaury Le Roux Dupeyron