Vaadin 24.2.7升级至24.3.2时出现IllegalStateException构建错误

问题详情 #

• Vaadin版本从24.2.7升级至24.3.2后，IntelliJ IDEA 2023.3.2（社区版）构建项目时抛出java.lang.IllegalStateException
• 直接触发原因：Vite构建进程以非零码终止，具体错误为@vaadin-component-factory/vcf-nav组件的vcf-nav.ts文件第13行@customElement装饰器位置提示「Expression expected」
• 已执行操作：删除node_modules、package.json、package-lock.json后重新构建，问题未解决
• 前置状态：24.2.7版本下项目可正常运行

报错堆栈 #

[报错堆栈原文]

POM文件内容 #

[pom文件原文]

解决方案建议 #

• 组件版本适配检查：Vaadin 24.3.x基于Lit 3.x，而旧版@vaadin-component-factory/vcf-nav可能仅兼容Lit 2.x（对应Vaadin 24.2系列），需升级该组件到适配Vaadin 24.3的版本
• 强制依赖同步：执行以下命令彻底清理并重新安装依赖

  mvn clean install -U
  mvn vaadin:clean-frontend vaadin:install-frontend
  

• TypeScript配置验证：检查项目根目录tsconfig.json的compilerOptions，确保target设置为ES2020或更高，同时experimentalDecorators设为true（Lit 3.x仍依赖装饰器语法，但对TS版本要求更高）
• 装饰器语法排查：确认vcf-nav.ts中@customElement的使用符合Lit 3.x规范，例如是否存在语法错误或过时写法（如旧版的customElement导入路径变化）

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