Azure制品库Maven项目下载制品GET请求失败排查

排查与解决步骤 #

1. 验证Azure Feed中制品的状态 #

• 登录Azure DevOps找到对应制品库，导航到路径com/project_name/project_name-support-maven-bom-artifact_name/2.1，确认project_name-support-maven-bom-artifact_name-2.1.zip是否存在，是否被误删或版本号标注错误。
• 检查权限：确认Maven使用的认证账号（PAT或服务账号）拥有该制品的读取权限，权限变更可能导致单个制品无法访问。

2. 清理Maven本地缓存 #

本地仓库对应路径可能存在损坏的缓存文件，执行以下命令删除后重新构建：

# Linux/macOS
rm -rf ~/.m2/repository/com/project_name/project_name-support-maven-bom-artifact_name/2.1

# Windows
rd /s /q %USERPROFILE%\.m2\repository\com\project_name\project_name-support-maven-bom-artifact_name\2.1

重新执行构建命令时强制更新依赖：

mvn clean install -U

3. 检查项目配置正确性 #

• 确认pom.xml中该依赖的配置参数（groupId、artifactId、version、type）完全匹配：

<dependency>
    <groupId>com.project_name</groupId>
    <artifactId>project_name-support-maven-bom-artifact_name</artifactId>
    <version>2.1</version>
    <type>zip</type>
</dependency>

• 检查maven-dependency-plugin的unpack配置，确保目标制品的参数和路径无错误：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>2.1</version>
    <executions>
        <execution>
            <id>unpack-artifact_name</id>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>com.project_name</groupId>
                        <artifactId>project_name-support-maven-bom-artifact_name</artifactId>
                        <version>2.1</version>
                        <type>zip</type>
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>

4. 验证Azure Feed端点与认证 #

• 检查settings.xml中Azure Feed的仓库配置，确认URL、认证信息（用户名/密码/PAT）无误：

<repositories>
    <repository>
        <id>Azure_artifact_feed</id>
        <url>https://feed_URL/maven/v1</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
    </repository>
</repositories>
<servers>
    <server>
        <id>Azure_artifact_feed</id>
        <username>你的账号名</username>
        <password>你的PAT令牌或密码</password>
    </server>
</servers>

• 用curl直接测试制品URL的可访问性：

curl -u 用户名:密码 https://feed_URL/maven/v1/com/project_name/project_name-support-maven-bom-artifact_name/2.1/project_name-support-maven-bom-artifact_name-2.1.zip

如果curl也无法下载，联系Azure制品库管理员排查仓库端问题；如果curl能下载，重点检查Maven配置细节。

5. 升级Maven依赖插件 #

当前使用的maven-dependency-plugin:2.1版本较旧，存在兼容性风险，尝试升级到最新稳定版（如3.6.0）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.0</version>
    <!-- 保留原有execution配置 -->
</plugin>

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