Bitbucket下载的依赖JAR损坏，Maven配置及本地安装遇问题求助

一、修复Bitbucket Downloads中JAR损坏问题 #

• 检查流水线打包上传逻辑：确认类库项目流水线中mvn clean package命令执行无异常，日志里package阶段输出完整，确保生成的JAR本身未损坏。
• 验证JAR完整性：手动下载Bitbucket Downloads里的JAR，执行jar tf auditlib-1.0.0.jar查看内部文件列表，若报错则说明上传过程中二进制流传输异常，需调整流水线上传方式（比如改用Bitbucket API的二进制上传模式，避免文本模式导致的损坏）。

二、基于Bitbucket的Maven依赖配置方案（无需独立仓库） #

方法1：使用Bitbucket Packages（推荐） #

Bitbucket自带私有Maven仓库功能，替代Downloads目录托管依赖：

1. 打开类库项目的Bitbucket仓库，启用Packages功能（Cloud版默认支持，Server版需确认插件）。
2. 修改类库项目pom.xml，添加发布配置，让流水线直接推送到Packages：

<distributionManagement>
    <repository>
        <id>bitbucket-maven-repo</id>
        <url>https://api.bitbucket.org/2.0/repositories/[你的用户名]/[类库仓库名]/maven/releases</url>
    </repository>
</distributionManagement>

3. 流水线中执行mvn deploy，将JAR发布到Bitbucket Packages，替代原来的Downloads上传步骤。
4. 在Spring Boot项目pom.xml中添加仓库和依赖：

<repositories>
    <repository>
        <id>bitbucket-maven-repo</id>
        <url>https://api.bitbucket.org/2.0/repositories/[你的用户名]/[类库仓库名]/maven/releases</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.audit.lib</groupId>
        <artifactId>auditlib</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

5. 在本地Maven的settings.xml中配置Bitbucket认证（用应用密码而非登录密码）：

<servers>
    <server>
        <id>bitbucket-maven-repo</id>
        <username>你的Bitbucket用户名</username>
        <password>你的Bitbucket应用密码</password>
    </server>
</servers>

方法2：直接引用Bitbucket Raw文件（应急方案） #

若无法使用Packages功能，可将JAR存放在类库仓库的目录中（如libs/auditlib-1.0.0.jar），通过Raw链接引入：

<dependency>
    <groupId>com.audit.lib</groupId>
    <artifactId>auditlib</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>https://bitbucket.org/[你的用户名]/[类库仓库名]/raw/[分支名]/libs/auditlib-1.0.0.jar</systemPath>
</dependency>

注意：需在settings.xml中配置Bitbucket认证，否则会触发403权限错误。

三、旧Maven版本本地安装的临时修复 #

若必须用旧Maven执行本地安装：

• 手动下载兼容的插件：从HTTPS的Maven中央仓库下载maven-install-plugin-2.5.2.jar，放到本地Maven插件目录（如~/.m2/repository/org/apache/maven/plugins/maven-install-plugin/2.5.2/）。
• 指定插件版本执行安装命令：

mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=auditlib-1.0.0.jar -DgroupId=com.audit.lib -DartifactId=auditlib -Dversion=1.0.0 -Dpackaging=jar -DgeneratePom=true

• 修改旧Maven的settings.xml，将中央仓库切换为HTTPS：

<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>

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