Gradle构建的最新Vaadin SpringBoot应用默认离线启动访问报错如何解决

出现该报错是因为 Vaadin 默认启用了 PWA 离线支持特性，不需要离线功能的话按照以下步骤配置即可完全关闭离线模式，强制所有资源在线加载： #

配置步骤 #

1. 关闭PWA相关配置 #

两种配置方式二选一即可：

• 方式一：修改启动类注解
  如果你的 Spring Boot 启动类上添加了@PWA注解，要么直接删除该注解，要么增加offline = false参数关闭离线能力：

import com.vaadin.flow.server.PWA;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
// 关闭离线模式
@PWA(name = "你的应用名称", shortName = "应用简称", offline = false)
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

• 方式二：通过配置文件全局关闭
  直接在application.properties（或application.yml）中添加如下配置：

# 完全禁用PWA特性
vaadin.pwa.enabled=false
# 禁用离线缓存能力
vaadin.offline-cache.enabled=false

2. 清理旧缓存重新构建 #

之前的构建已经生成了离线相关的缓存文件，需要先清理再启动避免残留：

1. 执行 Gradle 清理命令：./gradlew clean
2. 可选操作：删除项目根目录下的node_modules文件夹、package-lock.json/pnpm-lock.yaml文件，避免前端缓存影响
3. 重新启动应用即可正常访问，不会再触发离线页面加载逻辑

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