C++单元测试中ES2着色器编译失败及glGetAttribLocation报错排查

问题根源分析 #

1. 着色器源码非法传入：你看到GL_SHADER_SOURCE_LENGTH为3且内容是true，说明实际传入glShaderSource的不是合法顶点着色器代码，而是字符串"true"。大概率是文件读取逻辑出错——比如误将文件打开判断的布尔值（file.is_open()）写入了stringstream，而非读取文件内容。这种无效"源码"必然导致编译失败，GL_COMPILE_STATUS返回0。
2. glGetAttribLocation错误的连锁反应：着色器编译失败会导致后续程序链接也失败，此时调用glGetAttribLocation会触发GL_INVALID_OPERATION，因为程序对象未处于可用状态。

解决建议 #

1. 修复文件读取逻辑 #

确保正确读取着色器文件内容，而非写入无关值：

std::ifstream shaderFile("vertex.glsl");
if (!shaderFile.is_open()) {
    // 处理文件打开失败：输出错误日志、终止流程
    std::cerr << "Failed to open vertex.glsl" << std::endl;
    return;
}
std::stringstream ss;
// 读取整个文件内容到stringstream
ss << shaderFile.rdbuf();
std::string shaderSource = ss.str();

// 调试时可输出源码确认正确性
// std::cout << "Shader source: " << shaderSource << std::endl;

同时检查文件路径：单元测试的工作目录可能与开发环境不同，建议使用绝对路径，或在测试配置中指定正确的工作目录。

2. 完善着色器编译/链接的错误检查 #

编译和链接阶段必须获取详细错误日志，这是定位问题的核心：

编译错误检查

GLint compileStatus;
glGetShaderiv(vertexShader, GL_COMPILE_STATUS, &compileStatus);
if (compileStatus == GL_FALSE) {
    GLint logLen;
    glGetShaderiv(vertexShader, GL_INFO_LOG_LENGTH, &logLen);
    std::vector<char> logBuffer(logLen);
    glGetShaderInfoLog(vertexShader, logLen, nullptr, logBuffer.data());
    std::cerr << "Vertex shader compile error:\n" << logBuffer.data() << std::endl;
    // 清理无效着色器对象
    glDeleteShader(vertexShader);
    return;
}

链接错误检查

GLint linkStatus;
glGetProgramiv(program, GL_LINK_STATUS, &linkStatus);
if (linkStatus == GL_FALSE) {
    GLint logLen;
    glGetProgramiv(program, GL_INFO_LOG_LENGTH, &logLen);
    std::vector<char> logBuffer(logLen);
    glGetProgramInfoLog(program, logLen, nullptr, logBuffer.data());
    std::cerr << "Program link error:\n" << logBuffer.data() << std::endl;
    // 清理无效程序对象
    glDeleteProgram(program);
    return;
}

3. 修复glGetAttribLocation调用 #

• 确保程序成功链接后，再调用glGetAttribLocation
• 调用前先激活程序：glUseProgram(program)（部分实现允许不激活就查询，但严格遵循规范更稳妥）
• 确认顶点着色器中存在对应的attribute变量，且变量名拼写完全匹配（GLSL区分大小写）

4. 单元测试环境检查 #

• 确认OpenGL ES2上下文已正确初始化，所有GL调用必须在上下文创建后执行
• 若使用测试框架，确保测试用例的执行环境配置了正确的GL上下文

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