自建 gitlab 徽标问题导致项目 500 问题解决

· Frytea · 5 分钟 · 技术笔记
GitLab
自建 gitlab 徽标问题导致项目 500 问题解决

问题

最近内部 gitlab 某些项目打开就 500 了， 看 gitlab 报错日志如下：

gitlab  | {"method":"GET","path":"/xxx/xxx","format":"html","controller":"ProjectsController","action":"show","status":500,"time":"2025-08-28T00:51:41.511Z","params":[{"key":"namespace_id","value":"xxx"},{"key":"id","value":"xxx"}],"remote_ip":"10.17.7.63","user_id":74,"username":"xxxgitlab | {"method":"GET","path":"/xxx/xxx","format":"html","controller":"ProjectsController","action":"show","status":500,"time":"2025-08-28T00:51:41.511Z","params":[{"key":"namespace_id","value":"xxx"},{"key":"id","value":"xxx"}],"remote_ip":"10.17.7.63","user_id":74,"username":"xxx","ua":"Mozilla/5.0 (X11; Linux x86_64; rv:140.0) Gecko/20100101 Firefox/140.0","correlation_id":"01K3Q2F5DXP8Y33B25TW9SSMYM","meta.user":"xxx","meta.project":"xxx/xxx","meta.root_namespace":"storage","meta.caller_id":"ProjectsController#show","meta.remote_ip":"10.17.7.63","meta.feature_category":"projects","meta.client_id":"user/74","redis_calls":21,"redis_duration_s":0.007123,"redis_read_bytes":2997,"redis_write_bytes":2370,"redis_cache_calls":20,"redis_cache_duration_s":0.006591,"redis_cache_read_bytes":2816,"redis_cache_write_bytes":1035,"redis_shared_state_calls":1,"redis_shared_state_duration_s":0.000532,"redis_shared_state_read_bytes":181,"redis_shared_state_write_bytes":1335,"db_count":41,"db_write_count":0,"db_cached_count":10,"cpu_s":2.291446,"mem_objects":394125,"mem_bytes":52397272,"mem_mallocs":198648,"mem_total_bytes":68162272,"queue_duration_s":0.009214,"exception.class":"Rack::Timeout::RequestTimeoutException","exception.message":"Request ran for longer than 60000ms","exception.backtrace":["lib/gitlab/url_blocker.rb:113:in `getaddrinfo'","lib/gitlab/url_blocker.rb:113:in `get_address_info'","lib/gitlab/url_blocker.rb:48:in `validate!'","app/validators/addressable_url_validator.rb:83:in `validate_each'","app/models/badge.rb:43:in `build_rendered_url'","app/models/badge.rb:36:in `rendered_image_url'","app/models/badges/project_badge.rb:15:in `rendered_image_url'","app/views/projects/_home_panel

问题分析

经过 claude 的分析，发现是 badge 加载失败导致的

以下是完整回答：

根据这个 GitLab 日志，我可以看到问题的核心原因和解决方案：

问题分析

从日志中可以看到关键错误信息：

  1. 超时错误: Rack::Timeout::RequestTimeoutException (Request ran for longer than 60000ms) - 请求超过了60秒限制
  2. 根本原因: 错误发生在项目徽章(badge)渲染过程中，具体是在 lib/gitlab/url_blocker.rb:113:in 'getaddrinfo'
  3. 调用链: 项目页面渲染 → 徽章URL验证 → DNS解析超时

可能的原因

  1. 网络连通性问题: GitLab 尝试验证项目徽章的外部URL时，DNS解析或网络连接超时
  2. 徽章配置问题: 该项目配置了无效或无法访问的徽章URL
  3. 防火墙/代理问题: 网络策略阻止了对外部徽章服务的访问

解决方案

1. 临时解决方案 - 禁用徽章验证

方案无效。

2. 根本解决方案 - 检查项目徽章配置

  1. 通过管理员界面检查：

    • 进入该项目的设置页面

    • 查看 “General” → “Badges” 部分

    • 删除或修复无效的徽章URL

  2. 通过数据库直接检查：

按照这个步骤成功解决。

# 进入GitLab控制台
gitlab-rails console

# 查找该项目的徽章
project = Project.find_by_full_path('xxx/xxx')
project.badges.each { |badge| puts "#{badge.id}: #{badge.link_url} | #{badge.image_url}" }

# 删除有问题的徽章
Badge.where(id: [有问题的徽章ID]).delete_all

3. 网络诊断

检查 GitLab 服务器的网络连通性：

# 测试DNS解析
nslookup [徽章URL的域名]

# 测试网络连通性
curl -I [完整的徽章URL]

4. 增加调试信息

临时启用详细日志来定位具体的URL：

# 在 /etc/gitlab/gitlab.rb 中
gitlab_rails['log_level'] = 'debug'

建议先尝试解决方案1作为紧急修复，然后通过解决方案2找到并修复具体的徽章配置问题。这样既能快速恢复服务，又能从根本上解决问题。

结论

没想到一个 badge 会导致这么大问题，可能因为版本比较低,不知道新版本有没有解决这个问题。

返回文章列表