Spring Cloud Alibaba AI 依赖问题解决方案

问题背景

在使用Spring Cloud Alibaba AI组件时，开发者可能会遇到无法获取spring-ai-core 0.8.1版本依赖的问题。这个问题通常出现在配置了阿里云Maven镜像仓库的环境中，因为该版本的Spring AI组件尚未发布到Maven中央仓库。

原因分析

Spring AI作为一个相对较新的项目，其0.8.1版本目前只发布在Spring官方的里程碑仓库中，而没有同步到Maven中央仓库。当开发者配置了阿里云镜像仓库且使用了通配符镜像策略(<mirrorOf>*</mirrorOf>)时，所有依赖请求都会被重定向到阿里云仓库，导致无法获取Spring AI的相关组件。

解决方案

方案一：添加Spring里程碑仓库

在项目的pom.xml文件中显式添加Spring里程碑仓库配置：

<repositories>
    <repository>
        <id>spring-milestones</id>
        <name>Spring Milestones</name>
        <url>https://repo.spring.io/milestone</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

方案二：调整Maven镜像配置

修改settings.xml文件中的镜像配置，排除Spring里程碑仓库的镜像重定向：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*,!spring-milestones</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

注意：<mirrorOf>标签中的排除项!spring-milestones前不能有空格。

方案三：恢复默认Maven配置

临时将Maven配置恢复为默认状态，不使用任何镜像仓库。这种方法简单直接，但可能会影响其他依赖的下载速度。

最佳实践建议

1. 对于企业级开发环境，建议采用方案二，既保留阿里云镜像的加速优势，又能正确获取Spring AI组件
2. 在团队协作项目中，应将仓库配置统一写入项目pom.xml文件，而非依赖开发者的本地settings.xml配置
3. 随着Spring AI项目的成熟，后续版本可能会发布到中央仓库，届时可以简化配置

技术原理

Maven的仓库镜像机制允许将请求重定向到其他仓库，但当使用通配符*时，会覆盖所有仓库配置。通过!排除特定仓库，可以实现更精细的仓库访问控制。这种机制在需要使用特殊仓库(如Spring里程碑仓库、公司私有仓库等)时非常有用。

总结

Spring Cloud Alibaba AI作为阿里巴巴开源的AI集成方案，为开发者提供了便捷的AI能力接入方式。解决依赖获取问题后，开发者可以顺利开始Spring AI的探索和使用。随着Spring生态的不断发展，这类临时性的配置问题将会逐步减少。