VS Code中Spring Boot Devtools热重载功能失效问题求助

• 检查VS Code远程连接方式
  必须通过Remote - WSL扩展连接到Ubuntu环境，别直接打开Windows本地的项目文件夹。Devtools需要感知WSL内的文件变更，Windows目录的文件事件传递存在兼容性问题。同时在VS Code设置里确认java.autobuild.enabled已勾选，java.configuration.maven.userSettings指向WSL内的Maven配置（比如~/.m2/settings.xml）。

• 配置Devtools文件监听规则
  在src/main/resources/application.properties里添加以下配置：

  spring.devtools.restart.additional-paths=src/main/java
  spring.devtools.restart.poll-interval=2000ms
  spring.devtools.restart.quiet-period=1000ms
  

  明确指定监听Java源码目录，WSL下文件事件监听延迟较高，轮询模式更可靠。多模块项目可添加spring.devtools.restart.additional-exclude排除无关目录。

• 确认Maven自动构建状态
  打开VS Code命令面板（Ctrl+Shift+P）执行Maven: Toggle Auto Build，确保自动构建已开启。先手动执行一次mvn clean install，排除编译错误导致的热重载失败。检查pom.xml里的Devtools依赖，确保配置正确：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-devtools</artifactId>
      <scope>runtime</scope>
      <optional>true</optional>
  </dependency>
  

• 调整WSL系统监听参数
  WSL 2默认的inotify监听上限不足，在WSL终端执行以下命令扩容：

  echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
  sudo sysctl -p
  

  另外不要把项目放在Windows的NTFS分区（比如/mnt/c），移到WSL原生文件系统（比如/home/你的用户名/下），NTFS的文件事件传递在WSL中兼容性较差。

• 用正确方式启动项目
  放弃VS Code的"Run Java"命令，直接在WSL终端执行./mvnw spring-boot:run启动项目。启动日志里要能看到Devtools property defaults active!，如果看不到，在application.properties里显式添加spring.devtools.enabled=true。

• 优化VS Code扩展配置
  安装Spring Boot Dashboard扩展，通过该面板启动项目，它会自动适配WSL环境。同时在VS Code的settings.json里添加以下配置，确保文件保存时触发自动构建：

  "files.autoSave": "afterDelay",
  "java.compile.nullAnalysis.mode": "automatic"
  

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