RubyGems配置source_code_uri后部分Gem不显示源码链接问题咨询

现象 #

在RubyGems平台发布的多个Gem包中，部分可正常展示「Source Code」源码入口，部分无法展示。此前认为配置源码链接仅需要在.gemspec中设置source_code_uri元数据即可，不确定是否需要补充其他配置项。

配置对比如下：

# 可正常显示源码链接的配置
spec.metadata['source_code_uri'] = 'https://github.com/klueless-io/handlebars-helpers'

# 无法正常显示源码链接的配置
spec.metadata['source_code_uri'] = 'https://github.com/klueless-io/cmdlet'

必要配置与排查点 #

• 补全标准元数据字段：RubyGems的元数据渲染逻辑要求关联链接字段满足最小完整性要求，除source_code_uri外，必须同步配置homepage_uri字段，推荐同时补充changelog_uri、bug_tracker_uri字段，缺省核心字段时元数据不会被前端渲染。
• 校验仓库地址格式：配置的URI必须指向公开仓库的根目录，不能带/tree/main、/blob/master/xxx.gemspec这类路径后缀，末尾也不能加多余的斜杠，否则会被判定为无效源码地址，自动隐藏入口。
• 确认配置已随版本发布：本地修改.gemspec后必须重新构建gem包、推送新版本到RubyGems才会生效，仅修改远程仓库内的gemspec文件，不会同步更新RubyGems平台上已发布历史版本的展示信息。
• 检查仓库连通性：RubyGems后台会定期校验配置的源码地址可访问性，若仓库是私有状态、或校验时访问超时，会暂时隐藏源码链接，等下次校验通过后会自动恢复展示。
• 分支匹配校验：两个配置对应仓库的默认分支分别为master和main，如果构建gem时本地HEAD分支和远程默认分支不一致，也可能触发校验逻辑判定地址无效。

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