GLSL着色器程序链接失败与文件大小相关问题求助

问题现象 #

• 当着色器文件代码量较小时，程序稳定运行；
• 只要给任意着色器文件添加代码（哪怕是注释），程序启动成功率降至约50%，代码量越大，成功率越低。

成功运行的着色器代码 #

顶点着色器（vertex.vs） #

#version 460 core

layout (location = 0) in vec2 coords;

uniform float u_time;

out vec3 result_color;

void main()
{
    vec3 colorA = vec3(0.514f, 0.179f, 0.900f);
    vec3 colorB = vec3(0.895f, 0.359f, 0.488f);

    gl_Position = vec4(coords, 0.0f, 1.0f);
    result_color = colorA;
}

片段着色器（fragment.fs） #

#version 460 core

in vec3 result_color;

out vec4 color;

void main() 
{    
    color = vec4(result_color, 1.0f);
}

添加代码后的问题示例（顶点着色器） #

#version 460 core

layout (location = 0) in vec2 coords;

uniform float u_time;

out vec3 result_color;

// float wave(float x)
// {
//     return min(2.0f - 2.0f * fract(x / 2.0f), 
//                2.0f * fract(x / 2.0f));
// }

void main()
{
    vec3 colorA = vec3(0.514f, 0.179f, 0.900f);
    vec3 colorB = vec3(0.895f, 0.359f, 0.488f);

    // float frequency = 15.0f;
    // float y = wave(coords.x * frequency + cos(u_time) * 5.0f);
    // float fr_y = fract(coords.y * frequency + u_time);
    
    gl_Position = vec4(coords, 0.0f, 1.0f);
    result_color = colorA;
}

ShaderProgram类实现代码 #

#include <iostream>
#include <fstream>
#include <sstream>

#include <glad/glad.h>

#include "shader_program.h"

ShaderProgram::ShaderProgram(std::string vertexShaderPath, std::string fragmentShaderPath)
{
    std::ifstream vShaderFile;
    std::ifstream fShaderFile;
    std::stringstream vShaderStream;
    std::stringstream fShaderStream;

    vShaderFile.exceptions(std::ifstream::failbit | std::ifstream::badbit);
    fShaderFile.exceptions(std::ifstream::failbit | std::ifstream::badbit);

    try 
    {
        vShaderFile.open(vertexShaderPath);
        vShaderStream << vShaderFile.rdbuf();
    }
    catch(std::ifstream::failure e)
    {
        std::cout << "ERROR: FAILED TO READ SHADER FILE: VERTEX SHADER" << std::endl;
    }

    try 
    {
        fShaderFile.open(fragmentShaderPath);
        fShaderStream << fShaderFile.rdbuf();
    }
    catch(std::ifstream::failure e)
    {
        std::cout << "ERROR: FAILED TO READ SHADER FILE: FRAGMENT SHADER" << std::endl;
    }

    const char* vertexShaderSource = vShaderStream.str().c_str();
    const char* fragmentShaderSource = fShaderStream.str().c_str();

    CreateShaderProgram(vertexShaderSource, fragmentShaderSource);
}

unsigned int ShaderProgram::GetProgram()
{
    return program;
}

void ShaderProgram::CreateShaderProgram(const char* vertexShaderSource, const char* fragmentShaderSource)
{
    program = glCreateProgram();
    unsigned int vertexShader = CompileShader(GL_VERTEX_SHADER, vertexShaderSource);
    unsigned int fragmentShader = CompileShader(GL_FRAGMENT_SHADER, fragmentShaderSource);

    glAttachShader(program, vertexShader);
    glAttachShader(program, fragmentShader);
    glLinkProgram(program);

    int linkingResult;
    glGetProgramiv(program, GL_LINK_STATUS, &linkingResult);
    if (linkingResult == GL_FALSE)
    {
        char infoLog[512];
        glGetProgramInfoLog(program, 512, NULL, infoLog);
        std::cout << "ERROR: FAILED TO LINK PROGRAM\n" << infoLog << std::endl;
    }
}

unsigned int ShaderProgram::CompileShader(GLuint type, const char* source)
{
    unsigned int shader = glCreateShader(type);
    glShaderSource(shader, 1, &source, NULL);
    glCompileShader(shader);

    int compilationResult;
    glGetShaderiv(shader, GL_COMPILE_STATUS, &compilationResult);
    if (compilationResult == GL_FALSE)
    {
        char infoLog[512];
        glGetShaderInfoLog(shader, 512, NULL, infoLog);

        std::cout << "ERROR: FAILED TO COMPILE SHADER: " 
                  << (type == GL_VERTEX_SHADER ? "VERTEX" : "FRAGMENT") 
                  << " SHADER\n" << infoLog << std::endl;
    }

    return shader;
}

常见报错信息 #

报错1：链接失败（提示无main函数） #

ERROR: FAILED TO LINK PROGRAM
Vertex shader(s) failed to link, fragment shader(s) failed to link.
Vertex link error: INVALID_OPERATION.
ERROR: error(#97) No program main found
fragment link error: INVALID_OPERATION.
ERROR: error(#97) No program main found

报错2：无实际语法问题的编译错误 #

ERROR: FAILED TO COMPILE SHADER: VERTEX SHADER
Vertex shader failed to compile with the following errors:
ERROR: 0:1: error(#132) Syntax error: "0" parse error
ERROR: error(#273) 1 compilation errors.  No code generated


ERROR: FAILED TO LINK PROGRAM
Vertex shader(s) were not successfully compiled before glLinkProgram() was called.  Link failed.

问题根源与修复方案 #

根源分析 #

问题出在着色器源码指针的生命周期上：vShaderStream.str()返回的是临时std::string对象，调用.c_str()后，临时对象立即销毁，导致指针变成悬空指针。当着色器代码量小时，内存可能还没被覆盖，侥幸能运行；代码量越大，内存被覆盖的概率越高，OpenGL读取到的着色器源数据就会损坏，出现随机报错。

修复方法 #

将着色器源码保存为局部变量或类成员变量，确保c_str()返回的指针在编译、链接着色器期间始终有效：

方法1：使用局部变量保存字符串

修改构造函数中的指针赋值部分：

// 替换原指针赋值代码
std::string vertexShaderStr = vShaderStream.str();
std::string fragmentShaderStr = fShaderStream.str();
const char* vertexShaderSource = vertexShaderStr.c_str();
const char* fragmentShaderSource = fragmentShaderStr.c_str();

CreateShaderProgram(vertexShaderSource, fragmentShaderSource);

方法2：使用类成员变量持久化字符串

在ShaderProgram类中添加成员变量：

private:
    std::string vertexSource;
    std::string fragmentSource;

然后在构造函数中：

vertexSource = vShaderStream.str();
fragmentSource = fShaderStream.str();
const char* vertexShaderSource = vertexSource.c_str();
const char* fragmentShaderSource = fragmentSource.c_str();

额外优化建议 #

1. 编译失败后，调用glDeleteShader删除无效着色器对象，避免内存泄漏；
2. 链接失败后，删除着色器对象和程序对象；
3. 确保文件读取异常处理能正确捕获所有读取失败场景。

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