neo-java-web-api编译引用不存在版本问题求助

问题场景 #

使用SAP Cloud SDK的BOM进行依赖管理：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.sap.cloud.sdk</groupId>
            <artifactId>sdk-bom</artifactId>
            <version>3.75.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

显式声明neo-java-web-api依赖版本为4.32.5：

<dependencies>
...
    <dependency>
        <groupId>com.sap.cloud</groupId>
        <artifactId>neo-java-web-api</artifactId>
        <version>4.32.5</version>
    </dependency>
...
</dependencies>

但编译时仍尝试引用不存在的4.32.0版本，该问题从SAP Cloud SDK 3.74.0版本开始出现。

解决方案 #

方式1：在dependencyManagement中优先声明目标版本（推荐） #

Maven中，直接在dependencyManagement内声明的依赖版本优先级高于通过<scope>import</scope>导入的BOM版本。将neo-java-web-api的版本锁定放在SAP Cloud SDK BOM导入之前，即可强制覆盖BOM中的版本：

<dependencyManagement>
    <dependencies>
        <!-- 优先声明neo-java-web-api的目标版本 -->
        <dependency>
            <groupId>com.sap.cloud</groupId>
            <artifactId>neo-java-web-api</artifactId>
            <version>4.32.5</version>
        </dependency>
        <!-- 再导入SAP Cloud SDK BOM -->
        <dependency>
            <groupId>com.sap.cloud.sdk</groupId>
            <artifactId>sdk-bom</artifactId>
            <version>3.75.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

方式2：强制排除传递依赖中的旧版本 #

如果不想修改dependencyManagement，可以在dependencies中添加排除规则，确保没有其他依赖传递引入4.32.0版本：

<dependencies>
...
    <dependency>
        <groupId>com.sap.cloud</groupId>
        <artifactId>neo-java-web-api</artifactId>
        <version>4.32.5</version>
        <!-- 排除所有可能传递引入的旧版本 -->
        <exclusions>
            <exclusion>
                <groupId>com.sap.cloud</groupId>
                <artifactId>neo-java-web-api</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
...
</dependencies>

不过这种方式不如方式1可靠，因为无法完全避免其他依赖链带来的版本覆盖。

原因说明 #

SAP Cloud SDK 3.74.0及后续版本的BOM中，默认指定了neo-java-web-api的版本为4.32.0。Maven的依赖管理逻辑中，导入的BOM版本优先级会高于dependencies块中直接声明的版本，因此即使显式指定了4.32.5，仍会被BOM中的版本覆盖。通过在dependencyManagement中优先声明目标版本，可以打破这个优先级规则，强制使用指定的版本。

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