OpenWrt项目中特定Git提交无法获取的问题分析与解决

问题背景

在OpenWrt项目开发过程中，开发者发现当尝试从软件源（feed）中获取特定Git提交时会出现错误。具体表现为：当在feeds.conf配置文件中指定了某个软件源的确切提交哈希值时，系统无法正确获取该提交，并显示错误信息"Server does not allow request for unadvertised object"。

问题现象

开发者通过以下步骤可以复现该问题：

1. 创建feeds.conf文件，其中包含锁定到特定提交的软件源配置
2. 执行清理和更新软件源的操作

预期行为是获取到指定的提交哈希值，但实际行为却是获取失败，系统显示错误信息，并且最终软件源处于错误的提交状态。

技术分析

经过深入调查，发现该问题与Git服务器的配置有关。具体表现为：

1. 当使用HTTPS协议克隆仓库时会出现此问题
2. 使用Git协议则能正常工作
3. 问题根源在于Git服务器默认不允许请求未公开的SHA1哈希值

进一步研究发现，这是由于Git服务器的uploadpack.allowReachableSHA1InWant配置项默认为false导致的。这个配置项控制着是否允许客户端请求可达的SHA1哈希值。

解决方案

解决该问题的方法是在Git服务器上启用以下配置：

git config --system uploadpack.allowReachableSHA1InWant true

这个配置允许客户端请求服务器上可达的SHA1哈希值。根据Git文档，当远程服务器启用了uploadpack.allowReachableSHA1InWant选项时，客户端可以请求远程服务器上存在的40位十六进制SHA1哈希值。

技术细节

该问题特别影响OpenWrt项目中通过HTTPS协议获取软件源的操作。由于OpenWrt的构建系统会锁定软件源到特定提交以确保构建的可重复性，因此这个问题会直接影响项目的构建过程。

值得注意的是，这个问题在以下情况下不会出现：

1. 使用完整的仓库克隆（非浅克隆）
2. 使用Git协议而非HTTPS协议
3. 在配置修改前的Git服务器上

总结

这个问题的解决确保了OpenWrt项目能够继续使用HTTPS协议锁定软件源到特定提交，这对于维护构建系统的稳定性和可重复性至关重要。同时也提醒开发者，在使用浅克隆和特定提交锁定功能时，需要注意Git服务器的相关配置。

对于OpenWrt开发者来说，现在可以放心地在feeds.conf中指定软件源的确切提交哈希值，系统将能够正确获取所需的提交内容。