使用Maven与JOGL的GL3（OpenGL）时出现黑屏问题

我完全理解你尝试用JOGL的GL3 API绘制带简单着色器的四边形时遇到黑屏的挫败感——尤其是GL2能正常渲染三角形，但切换到GL3的着色器路径就卡壳，而且DebugGL只出警告没错误，确实让人摸不着头脑。我来帮你一步步排查可能的问题点：

1. GL3核心模式强制要求VAO（顶点数组对象） #

GL3的核心上下文不允许隐式使用顶点数据，必须显式创建并绑定VAO，这是核心模式和GL2兼容模式最关键的差异之一，也是黑屏的头号元凶。你当前的代码里完全没看到VAO的创建逻辑，这大概率是问题所在。

修复步骤： #

在SimpleQuadRenderer中添加VAO、VBO的初始化和绑定逻辑：

private int vaoId;
private int vboId;
private int programId; // 你需要保存ShaderLoader返回的programId

@Override
public void init(GLAutoDrawable drawable) {
    GL3 gl = drawable.getGL().getGL3();
    // 1. 创建并绑定VAO
    int[] vaoArr = new int[1];
    gl.glGenVertexArrays(1, vaoArr, 0);
    vaoId = vaoArr[0];
    gl.glBindVertexArray(vaoId);

    // 2. 准备四边形顶点数据（用三角扇绘制4个顶点组成四边形）
    float[] vertices = {
        -0.5f,  0.5f, 0.0f, // 左上
        -0.5f, -0.5f, 0.0f, // 左下
         0.5f, -0.5f, 0.0f, // 右下
         0.5f,  0.5f, 0.0f  // 右上
    };
    // 3. 创建并绑定VBO（顶点缓冲对象）
    int[] vboArr = new int[1];
    gl.glGenBuffers(1, vboArr, 0);
    vboId = vboArr[0];
    gl.glBindBuffer(GL3.GL_ARRAY_BUFFER, vboId);
    FloatBuffer vertexBuffer = Buffers.newDirectFloatBuffer(vertices);
    gl.glBufferData(GL3.GL_ARRAY_BUFFER, vertexBuffer.limit() * Float.BYTES, vertexBuffer, GL3.GL_STATIC_DRAW);

    // 4. 关联顶点属性与着色器输入（对应着色器中location=0的变量）
    gl.glEnableVertexAttribArray(0);
    gl.glVertexAttribPointer(0, 3, GL3.GL_FLOAT, false, 0, 0);

    // 5. 初始化着色器程序
    ShaderLoader shaderLoader = new ShaderLoader(gl, "path/to/vert.glsl", "path/to/frag.glsl");
    programId = shaderLoader.getProgramId();

    // 解绑VAO和VBO（好习惯，避免后续误操作）
    gl.glBindVertexArray(0);
    gl.glBindBuffer(GL3.GL_ARRAY_BUFFER, 0);
}

在display方法中必须绑定VAO再绘制：

@Override
public void display(GLAutoDrawable drawable) {
    GL3 gl = drawable.getGL().getGL3();
    // 清除颜色缓冲
    gl.glClearColor(0.0f, 0.0f, 0.0f, 1.0f);
    gl.glClear(GL3.GL_COLOR_BUFFER_BIT);

    // 激活着色器程序
    gl.glUseProgram(programId);
    // 绑定VAO
    gl.glBindVertexArray(vaoId);
    // 绘制四边形（三角扇模式，4个顶点）
    gl.glDrawArrays(GL3.GL_TRIANGLE_FAN, 0, 4);
    // 解绑VAO和程序
    gl.glBindVertexArray(0);
    gl.glUseProgram(0);
}

2. 确保GLSL着色器与GL3版本匹配 #

GL3对应的GLSL版本是130，你的着色器必须声明正确的版本，并且顶点着色器要明确指定顶点属性的位置：

顶点着色器示例（vert.glsl） #

#version 130
layout(location = 0) in vec3 aPos; // 对应Java代码中location=0的顶点属性

void main() {
    gl_Position = vec4(aPos, 1.0);
}

片段着色器示例（frag.glsl） #

#version 130
out vec4 FragColor;

void main() {
    FragColor = vec4(1.0, 0.0, 0.0, 1.0); // 红色四边形
}

同时检查你代码中打印的compile status和link status，必须都是1（对应GL_TRUE），如果不是，根据输出的日志排查着色器语法错误。

3. 补全reshape方法的视口设置 #

GL3需要显式设置视口，否则渲染内容可能被输出到不可见区域：

@Override
public void reshape(GLAutoDrawable drawable, int x, int y, int w, int h) {
    GL3 gl = drawable.getGL().getGL3();
    gl.glViewport(x, y, w, h);
}

4. 手动检查GL错误 #

虽然DebugGL没报错误，但可以在关键GL调用后手动检查错误，捕捉隐性问题：

// 在init或display的关键步骤后添加
int error = gl.glGetError();
if (error != GL3.GL_NO_ERROR) {
    System.err.println("GL错误代码: " + error);
}

5. 资源清理（可选但推荐） #

在dispose方法中释放创建的OpenGL资源，避免内存泄漏：

@Override
public void dispose(GLAutoDrawable drawable) {
    GL3 gl = drawable.getGL().getGL3();
    gl.glDeleteBuffers(1, new int[]{vboId}, 0);
    gl.glDeleteVertexArrays(1, new int[]{vaoId}, 0);
    gl.glDeleteProgram(programId);
}

内容来源于stack exchange