com.microsoft.sqlserver:sqljdbc4:jar:4.0 was not found产生原因及解决步骤

问题

sqlserver 包找不到

springboot项目，maven中 sqlserver依赖找不到

Could not resolve dependencies for project *****:jar:1.0.2: com.microsoft.sqlserver:sqljdbc4:jar:4.0 was not found in https://repo.maven.apache.org/maven2 during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of central has elapsed or updates are forced -> [Help 1] 

报错原因分析

该错误的根本原因是 Maven 无法在默认的中央仓库（Maven Central）中找到 com.microsoft.sqlserver:sqljdbc4:jar:4.0 这个依赖。由于在前一次构建尝试时，依赖解析失败，因此 Maven 将这个结果缓存起来，导致后续构建不会再重新尝试解析这个依赖，直到本地缓存过期或手动强制更新。

主要原因

1. 依赖不在 Maven 中央仓库：Microsoft 的 sqljdbc4 驱动程序并没有托管在 Maven 的中央仓库中，Maven 默认不会从其他仓库（如 Microsoft 的私有仓库）获取该依赖。
2. 本地缓存问题：Maven 缓存了前一次解析失败的结果，并不会在下一次构建时重新尝试解析，除非手动更新缓存。
3. 仓库配置不完整：pom.xml 文件中缺少对 Microsoft 的私有 Maven 仓库的配置，导致无法正确下载依赖。

解决方案

步骤 1：检查 pom.xml 中的依赖声明

首先，确认你在 pom.xml 中正确添加了 sqljdbc4 依赖。正确的依赖声明应如下所示：

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>sqljdbc4</artifactId>
    <version>4.0</version>
</dependency>

步骤 2：配置 Microsoft 的 Maven 仓库

因为 sqljdbc4 并未托管在 Maven 中央仓库，所以你需要手动在 pom.xml 中添加 Microsoft 的私有仓库地址。你可以在 repositories 节点下添加以下配置：

<repositories>
    <repository>
        <id>microsoft</id>
        <url>https://maven.microsoft.com/maven2/</url>
    </repository>
</repositories>

步骤 3：强制更新 Maven 依赖

由于前一次构建尝试的失败结果被缓存，你需要强制更新 Maven 依赖。可以使用 -U 选项来强制更新 Maven 的依赖：

mvn clean install -U

-U 参数会强制 Maven 忽略本地缓存，并从远程仓库重新下载依赖。

步骤 4：清理本地仓库缓存

如果强制更新后依然无法解决问题，可能是本地仓库中的缓存依赖引起的。可以通过以下命令清理本地仓库中的缓存依赖：

mvn dependency:purge-local-repository

这将清除所有本地缓存的依赖项，并重新下载。

步骤 5：手动下载并安装 sqljdbc4.jar

如果上述步骤未能解决问题，你可以手动下载 sqljdbc4.jar 并将其安装到本地 Maven 仓库中：

1. 前往 Microsoft 下载中心 下载 sqljdbc4.jar 文件。
2. 使用以下命令将 sqljdbc4.jar 手动安装到本地 Maven 仓库：

mvn install:install-file \
    -Dfile=/path/to/sqljdbc4.jar \
    -DgroupId=com.microsoft.sqlserver \
    -DartifactId=sqljdbc4 \
    -Dversion=4.0 \
    -Dpackaging=jar

将 /path/to/sqljdbc4.jar 替换为你本地实际的 sqljdbc4.jar 文件路径。

步骤 6：修改 Maven 的 updatePolicy（可选）

如果你的网络环境较慢或某些代理问题导致更新失败，你可以尝试通过修改 Maven 的 updatePolicy 强制每次构建都检查远程仓库中的更新。在你的 settings.xml 中配置以下内容：

<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <releases>
            <updatePolicy>always</updatePolicy>
        </releases>
    </repository>
</repositories>

这样做会强制 Maven 在每次构建时检查依赖的更新状态。

总结

1. 确认 pom.xml 中的依赖配置是否正确。
2. 添加 Microsoft Maven 仓库到 pom.xml 中。
3. 强制更新依赖并清理本地缓存。
4. 如有需要，手动下载并安装 sqljdbc4.jar。
5. 根据网络环境，调整 updatePolicy 以强制更新依赖。

希望对你有所帮助，若有问题欢迎指正~😊