Fetching sass-embedded 1.100.0 (x86_64-linux-gnu) 卡死了

AI 生成的摘要

singi2016cn报告在构建Discourse时,尽管配置了清华大学镜像源,bundle install 仍在获取 sass-embedded 等 gem 时卡死,日志显示部分请求仍指向 https://rubygems.org/。

随后,singi2016cn深入分析了根本原因。问题源于 Gemfile.lock 中指定的 Bundler 版本(4.0.11)与基础镜像中自带的较新版本(4.1.x)不一致。当构建过程中安装旧版 Bundler 并重新执行时,由于上游已知 bug(ruby/rubygems#10073 和 #10075),新版 Bundler (4.1) 在写入 .bundle/config 时会给包含 : 的 key(如 mirror.https://rubygems.org/)加上引号,导致旧版 Bundler (4.0.11) 无法识别镜像配置,从而静默忽略镜像设置并直接连接官方源。

提供的修复方案包括:

  1. 修改配置文件:手动编辑 .bundle/config,移除 key 中的引号。
  2. 使用 mirror.all:配置 bundle config mirror.all https://mirrors.tuna.tsinghua.edu.cn/rubygems/,该 key 在新旧版本下均兼容。
  3. 直接修改 Gemfile.lock:使用 sed 命令将锁文件中的 remote: https://rubygems.org/ 替换为镜像地址。

作者验证修复后,构建日志仅显示从镜像源获取元数据,且各 gem 能正常下载。该问题预计将在基础镜像更新 Bundler 至 4.1.1 及以上版本后彻底解决。

今天构建时,被这个包卡死了。大家有什么好办法吗?使用镜像源也不行。


Fetching gem metadata from https://mirrors.tuna.tsinghua.edu.cn/rubygems/.
Fetching bundler 4.0.11
Installing bundler 4.0.11
Fetching gem metadata from https://rubygems.org/........


Fetching rotp 6.3.0
Fetching rubyzip 3.3.1
Fetching sanitize 7.0.1
Fetching sass-embedded 1.100.0 (x86_64-linux-gnu)

@david Hi,为什么配置了镜像,这里还是走的 https://rubygems.org/,有什么办法让这里也走镜像吗?

web.china.template.yml 如下

hooks:
  before_code:
    - exec:
        cmd:
          - su discourse -c 'git config --global url."http://154.164.197.10:5000/https://github.com/".insteadOf "https://github.com/"'

  before_web:
    - exec:
        cmd:
          - su discourse -c 'gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/ --remove https://rubygems.org/'

  before_yarn:
    - exec:
        cmd:
          - su discourse -c 'pnpm config set registry https://registry.npmmirror.com --global'

  before_bundle_exec:
    - exec:
        cmd:
          - su discourse -c 'bundle config mirror.https://rubygems.org https://mirrors.tuna.tsinghua.edu.cn/rubygems'

修复 discourse_docker 构建:配了镜像仍走 rubygems.org 卡死

Context(根因)

构建日志的关键序列:

Fetching gem metadata from https://mirrors.tuna.tsinghua.edu.cn/rubygems/.   ← 第一跑(base 镜像自带 Bundler 4.1.x),镜像生效
Fetching bundler 4.0.11 / Installing bundler 4.0.11                          ← Gemfile.lock 的 BUNDLED WITH=4.0.11 触发自动安装并 re-exec
Fetching gem metadata from https://rubygems.org/........                     ← 第二跑(Bundler 4.0.11),镜像被静默忽略
Fetching rotp / rubyzip / sanitize / sass-embedded ...                       ← 从 rubygems.org 下载 → 国内网络卡死

已核实的事实链:

  1. Gemfile.lock 中 BUNDLED WITH = 4.0.11(本地 release/2026.7 分支已确认,Gemfile.lock:1339);discourse_docker 的 base 镜像自带更新版 Bundler(4.1.x),构建时必然自动安装 4.0.11 并 re-exec。
  2. Bundler 4.0.11 的 mirror 匹配代码与 2.x 完全一致(key 正则 \Amirror\.(all|.+?)(\.fallback_timeout)?\/?\z,先按规范化 URI、再按 host 匹配)——mirror 机制本身没有被移除。
  3. 真正根因是 ruby/rubygems#10073 / #10075(2026-11-16 报告,正好本周):
    • Bundler 4.1 改用完整 Gem::YAMLSerializer 写 .bundle/config,会给所有含 : 的 key 加引号 → 写出 "mirror.https://rubygems.org/": "https://..."
    • Bundler 4.0 用 RubyGems 3.5–4.0 的简化读取器,把引号当作 key 的一部分 → mirror 配置被静默忽略,回退原始源 rubygems.org
  4. 所以:4.1 写的配置它自己读得懂(第一跑走 tuna),re-exec 后的 4.0.11 读不懂(第二跑走 rubygems.org)。上游写侧修复在 Bundler 4.1.1,但 Discourse 锁死 BUNDLED WITH=4.0.11,构建总会回退到 4.0.11 —— 必须在配置侧绕开。

修复方案(推荐):改用 mirror.all

mirror.all 这个 key 不含冒号,Bundler 4.1 的写侧不会给它加引号,4.0.11 的读取器可以正常识别;2.7~4.x 所有版本的读取正则都支持 all。对唯一 rubygems 源的 Discourse 工程,效果与 mirror.https://rubygems.org/ 完全等价。

操作:在服务器上找到现有那条 bundle config mirror... 命令(在 containers/app.yml 的 hooks、自定义 template、或改过的 templates/web.template.yml 里),把 mirror key 换成 mirror.all,其余保持原样(尤其保持与 bundle install 相同的用户上下文,如 su discourse -c):

- exec:
    cmd:
      - su discourse -c 'bundle config set --global mirror.all https://mirrors.tuna.tsinghua.edu.cn/rubygems/'

如果找不到原来的位置,直接在 containers/<app>.yml 加 hook(web.template.yml 的 bundle 安装 exec 带 hook: bundle_exec,pups 支持 before_/after_ 前缀注入):

hooks:
  before_bundle_exec:
    - exec:
        cmd:
          - su discourse -c 'bundle config set --global mirror.all https://mirrors.tuna.tsinghua.edu.cn/rubygems/'

注意:替换旧的 mirror.https://rubygems.org/... 那条命令,不要两条并存;不要配置 mirror.*.fallback_timeout(镜像慢时会回退 rubygems.org,反而复现卡死)。

备选方案(若 mirror.all 仍被绕过):直接改写 Gemfile 与 lock 的 remote

完全不依赖 bundler 配置机制,把源直接替换成镜像(after_code hook 在 git checkout 之后、bundle 之前执行):

hooks:
  after_code:
    - exec:
        cd: $home
        cmd:
          - sed -i 's|https://rubygems.org|https://mirrors.tuna.tsinghua.edu.cn/rubygems/|g' Gemfile
          - sed -i 's|remote: https://rubygems.org/|remote: https://mirrors.tuna.tsinghua.edu.cn/rubygems/|g' Gemfile.lock

验证

  1. (可选,30 秒确认根因)在服务器上看现有配置是否已被 4.1 写成带引号的 key:
    cd /var/discourse && ./launcher enter app   # 或任一能进容器的方式
    grep -rn mirror /home/discourse/.bundle/config /var/www/discourse/.bundle/config /root/.bundle/config 2>/dev/null
    # 若看到 "mirror.https://rubygems.org/":(key 带引号)→ 根因确认
    
  2. ./launcher rebuild app,观察 bundle 步骤日志:
    • 只应出现 Fetching gem metadata from https://mirrors.tuna.tsinghua.edu.cn/rubygems/
    • 不应再出现 Fetching gem metadata from https://rubygems.org/
    • rotp / rubyzip / sanitize / sass-embedded 能正常下载完成
  3. 镜像构建成功、容器启动、站点可访问。

后续跟踪

  • 上游 ruby/rubygems#10075 的写侧修复随 Bundler 4.1.1 发布;等 discourse/base 镜像带上 ≥4.1.1 后,旧写法 mirror.https://rubygems.org/ 会恢复可用。mirror.all 在新旧版本下都安全,可以一直保留。
  • 相关背景:Bundler 4 升级说明、bundler 自安装走 rubygems.org 的老问题 #5498 / #8999(本例中 4.0.11 自安装这一步是成功的,不是卡点)。