Vaadin 20初始化项目pom.xml报依赖找不到错误问题求助

触发问题的核心原因 #

• Maven 3.8.1默认在全局配置中添加了HTTP仓库拦截规则，部分Vaadin 20初始生成的pom.xml如果残留了HTTP协议的Vaadin官方仓库配置，会直接被拦截导致依赖拉取失败。
• 若你本地Maven配置了第三方公共镜像，新版本组件同步会存在1-72小时的延迟，会出现官方仓库已发布、但镜像源暂未收录对应版本的情况。
• 如果settings.xml中配置了全局镜像（mirrorOf属性为*），会强制所有依赖都走指定镜像，哪怕pom中配置了其他仓库也不会生效，无法拉取镜像未收录的版本。
• Vaadin部分小版本、增量版本会优先推送到Vaadin官方仓库，存在数天的Maven Central同步窗口期，仅配置Maven Central会拉取不到刚发布的新版本。
• IntelliJ IDEA的本地Maven索引缓存未及时更新，也会出现IDE层面误报依赖不存在的问题。

遗漏的配置项 #

要正常使用Vaadin 20.0.1 + Spring Boot 2.4.6组合，需要在pom.xml中补充Vaadin官方HTTPS仓库配置，示例如下：

<!-- 依赖仓库配置 -->
<repositories>
    <repository>
        <id>vaadin-releases</id>
        <url>https://maven.vaadin.com/vaadin-releases</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

<!-- 插件仓库配置 -->
<pluginRepositories>
    <pluginRepository>
        <id>vaadin-plugin-releases</id>
        <url>https://maven.vaadin.com/vaadin-releases</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </pluginRepository>
</pluginRepositories>

配套排查操作 #

补充配置后如果仍有报错，可依次执行以下操作：

1. 执行mvn clean install -U命令强制拉取最新版本信息，跳过本地缓存校验
2. 点击IntelliJ IDEA Maven面板的「Reload All Maven Projects」按钮刷新项目依赖索引
3. 清空本地Maven仓库中org/springframework/boot/spring-boot-starter-parent/2.4.6和com/vaadin/vaadin-maven-plugin/20.0.1目录，重新触发依赖拉取

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