Packagist 上关联的 Github 开源项目 star 数显示异常如何排查？

常见成因 #

• 同步机制不匹配：常规配置的Webhook仅会在项目有代码提交、版本发布时触发增量同步，同步范围优先覆盖代码版本、依赖配置、描述信息等核心包元数据，Star数属于社区互动类指标，不在Webhook触发的即时同步范围内，Packagist对这类指标的默认同步周期为24小时。
• 元数据关联偏差：如果最初上传包时关联的仓库地址，不是当前累计获得10个Star的正式仓库（比如关联了早期测试版仓库、Fork副本仓库、归档迁移仓库），就会出现Star数长期偏低的情况，因为系统拉取的始终是关联仓库的旧数据。
• 权限不足导致的拉取异常：如果配置Webhook时使用的GitHub应用Token未开通公开仓库元数据的读取权限，Packagist无法正常拉取Star数值的最新统计，就会固定显示首次上传时抓取到的1个Star的初始值。

可落地的解决步骤 #

• 首先核对Packagist包详情页的关联仓库地址，确保和拥有10个Star的正式项目地址完全一致，没有指向其他关联仓库。
• 进入Packagist的包管理控制台，点击手动全量刷新按钮，触发包含Star数在内的全维度元数据拉取，不要依赖Webhook的增量更新流程。
• 检查Webhook的回调日志，确认GitHub接口返回的Star数字段和实际值匹配，如果存在权限缺失，重新配置Webhook的Token权限范围即可。

系统侧已知问题 #

Star数这类非核心字段，Packagist存在历史已知的缓存失效问题：当对应字段的本地缓存条目被标记为永久有效时，不会按照常规周期刷新，会一直沿用首次同步的初始值，这种情况不属于用户配置疏漏，必须通过手动全量刷新才能解决，等待自动同步永远无法拿到正确数值。

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