GitLab项目徽章配置求助：CI/CD生成的徽章无法显示

核心问题：链接路径错误 #

你当前使用的URL包含%{commit_sha}变量，这个变量会绑定到某次特定提交的制品，导致后续提交后徽章无法加载最新内容，同时GitLab的制品链接规范中，指向分支最新制品不需要该参数。

修正后的链接格式 #

• 跳转链接（指向ESLint报告）：

  https://gitlab.ensimag.fr/%{project_path}/-/jobs/artifacts/%{default_branch}/raw/rapport1.txt?job=eslint
  

• 徽章图片URL：

  https://gitlab.ensimag.fr/%{project_path}/-/jobs/artifacts/%{default_branch}/raw/eslint1.svg?job=badges
  

额外排查点 #

1. 确认徽章配置位置
   登录GitLab项目后，进入Settings > General > Badges，添加徽章时直接填入上述链接，GitLab会自动替换%{project_path}和%{default_branch}变量。

2. 验证制品有效性

   • 手动访问修正后的图片URL，检查是否能正常加载SVG文件：
     1. 进入项目的CI/CD > Jobs，找到最新的badges job
     2. 进入Artifacts，下载eslint1.svg确认是有效的SVG格式
   • 确保generateBadges.sh脚本在项目根目录执行，生成的eslint1.svg路径与.gitlab-ci.yml中badges job的artifacts.paths一致。

3. 权限检查

   • 如果项目是私有/内部项目，确保访问徽章的用户有项目的访问权限；若需要公开访问徽章，需将项目设置为公开，或为徽章链接配置项目访问令牌（不推荐公开令牌）。

4. 脚本逻辑验证
   检查generateBadges.sh中的条件判断，bash中规范写法如下（避免语法问题导致徽章生成失败）：

   if [[ $NBERR -gt 0 ]]; then
     color="red"
   elif [[ $NBWARN -gt 0 ]]; then
     color="orange"
   else
     color="green"
   fi
   

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