Vaadin 23.1.1 vaadin-maven-plugin找不到update-theme目标如何解决

云原生阿岚

2026-8-26

问题根因

update-theme 是Vaadin 14及更早LTS版本中vaadin-maven-plugin提供的内置目标，从Vaadin 23版本开始，官方已经彻底移除了该目标，原有的主题资源扫描、样式编译、静态资源处理逻辑，已经被完全整合进prepare-frontend和build-frontend两个目标中。
出现该报错的唯一触发条件是：项目Maven配置中残留了旧版Vaadin的执行规则，手动绑定了已经被废弃删除的update-theme目标，通常是照搬旧版本Vaadin项目的pom配置、参考了2022年Vaadin23正式发布前的过时教程导致的。

排查修复步骤

打开项目根目录下的pom.xml文件，全局搜索update-theme关键词，定位到com.vaadin:vaadin-maven-plugin插件下的执行配置段，该配置一般位于<build><plugins>标签内，会出现在<execution>节点的<goals>列表中。
直接删除所有引用update-theme的<goal>配置项，无需找替代目标绑定。Vaadin 23版本的插件配置只需要保留两个官方要求的标准目标即可，参考正确配置如下：

<plugin>
  <groupId>com.vaadin</groupId>
  <artifactId>vaadin-maven-plugin</artifactId>
  <version>23.1.1</version>
  <executions>
    <execution>
      <goals>
        <goal>prepare-frontend</goal>
        <goal>build-frontend</goal>
      </goals>
    </execution>
  </executions>
</plugin>

清理本地项目缓存与Maven依赖缓存，在项目根目录执行命令mvn clean install -U，强制拉取正确版本的依赖后重新构建即可。
如果是从Vaadin 14、Vaadin 21/22等旧版本升级到23的项目，还需要排查所有第三方Vaadin组件、主题扩展依赖，将所有依赖版本对齐到当前使用的Vaadin 23.1.1版本，避免旧版本依赖自动引入过时的插件配置。