Tycho从2.7.5升级到4.0.5后p2.index重下载致构件解析失败

核心问题分析 #

Tycho 4.x版本对p2仓库的缓存机制做了调整，和2.x版本的缓存逻辑存在差异。当构建因surefire.timeout失败、或单构建时长超过1小时时，p2.index会被强制重新下载，但本地缓存的旧构件元数据未同步更新，导致索引与本地缓存的构件版本不匹配，最终触发bundleLocation can't be null for artifact eclipse-plugin:org.apache.xmlbeans:2.6.0.202502211234: null这类解析错误。

解决方案 #

1. 延长p2.index缓存时长，避免重复下载 #

在父pom.xml的properties节点中配置更长的缓存阈值，覆盖Tycho默认的1小时缓存限制：

<properties>
    <!-- 设置为24小时缓存，减少p2.index重复下载频率 -->
    <tycho.p2.transport.min-cache-minutes>1440</tycho.p2.transport.min-cache-minutes>
    <!-- 固定使用ecf传输机制，提升缓存稳定性 -->
    <tycho.p2.transport>ecf</tycho.p2.transport>
</properties>

如果是命令行构建，直接追加参数：

mvn clean install -Dtycho.p2.transport.min-cache-minutes=1440 -Dtycho.p2.transport=ecf

若需手动更新p2.index，直接删除本地Tycho p2缓存目录（默认路径~/.m2/repository/.cache/tycho/p2）后重新构建即可。

2. 调整Artifactory的p2仓库缓存策略 #

在Artifactory后台修改p2仓库配置：

• 开启元数据缓存（包含p2.index、artifacts.xml等文件），设置缓存时长为24小时以上
• 关闭元数据的强制刷新选项，避免Artifactory主动推送更新的p2.index给Tycho
• 确保快照构件的元数据与构件文件同步缓存，防止出现索引更新但构件未缓存的脱节情况

3. 修复构建超时问题，从根源减少p2.index重下 #

• 针对surefire.timeout失败：调整Surefire插件的超时参数，在pom.xml中添加配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <!-- 根据测试实际运行时长调整，示例设为3600秒 -->
                <timeout>3600000</timeout>
            </configuration>
        </plugin>
    </plugins>
</build>

• 优化构建性能：拆分大型构建模块，使用-T 1C参数启用并行构建，缩短单模块构建时长，避免触发1小时的p2.index重下阈值

4. 强制Tycho在p2.index更新后重新解析构件 #

如果必须允许p2.index更新，可在构建前清理Tycho的p2构件缓存，确保重新下载最新版本：

# 清理Tycho p2缓存目录
rm -rf ~/.m2/repository/.cache/tycho/p2
# 执行构建
mvn clean install

也可通过maven-clean-plugin配置自动清理缓存：

<plugin>
    <artifactId>maven-clean-plugin</artifactId>
    <version>3.3.2</version>
    <configuration>
        <filesets>
            <fileset>
                <directory>${user.home}/.m2/repository/.cache/tycho/p2</directory>
                <includes>
                    <include>**/*</include>
                </includes>
            </fileset>
        </filesets>
    </configuration>
</plugin>

5. 临时降级Tycho版本 #

若以上方案均无法解决问题，可临时降级Tycho到3.x版本（如3.0.5），该版本的p2缓存逻辑与2.7.5更接近，能规避此类缓存不一致问题，待Tycho官方修复相关bug后再升级。

验证方法 #

1. 执行构建，观察日志确认无p2.index重复下载记录
2. 模拟构建超时后重新执行，检查构件解析是否正常，无bundleLocation can't be null错误
3. 等待超过1小时后重新构建，验证构件解析流程正常

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