Spring Boot修改静态文件后重启异常求助（Windows/Mac差异）

我经手过不少跨平台的Spring Boot DevTools问题，这个差异其实主要和操作系统文件机制、IDE行为以及DevTools的触发逻辑有关，咱们一步步拆解：

核心背景：DevTools的两种重载机制 #

首先得明确，DevTools针对静态资源和类文件有两种不同的处理逻辑：

• 静态资源（CSS/JS/HTML）：默认支持实时刷新（不用重启应用，只重新加载资源）
• 类文件/配置文件变更：触发应用重启（Tomcat重启）

你的情况是Windows下误触发了重启逻辑，而Mac上是正常的静态资源刷新，原因大概率是下面几个点：

1. 文件系统通知的跨平台差异 #

Windows和Mac的文件系统（NTFS vs APFS）对文件变化的通知机制不一样：

• Windows的文件系统通知可能会把某些“辅助操作”（比如IntelliJ保存静态文件时生成的临时缓存、文件复制的中间状态）误判为类路径下的文件变更，DevTools接收到后就触发了重启。
• Mac的APFS文件系统对文件变化的通知更精准，DevTools能清晰区分“静态资源修改”和“类文件/配置变更”，所以只执行静态资源刷新。

2. IntelliJ IDEA的文件同步逻辑差异 #

IntelliJ在Windows和Mac上的自动保存、文件同步行为有细微差别：

• 如果你在Windows上开启了「Settings > Build, Execution, Deployment > Compiler」里的Build project automatically，修改静态文件时可能不小心触发了后台编译（比如某些关联的配置文件被修改），生成了.class文件，DevTools检测到类路径变化就会重启。Mac上可能这个选项没开，或者自动编译的触发条件更严格。
• 另外，Windows上IntelliJ的“Save All”操作可能会同步修改更多文件（比如.idea目录下的配置缓存），这些文件如果被DevTools监听，也会触发重启。

3. DevTools排除规则的生效差异 #

DevTools默认通过spring.devtools.restart.exclude配置排除了静态资源目录，但Windows的大小写不敏感特性可能导致某些场景下规则失效：
比如如果你的静态目录实际是Static（大写），但配置里写的是static（小写），Windows下还能匹配排除，但如果反过来（配置是大写，实际是小写），可能在某些情况下没生效？不过更多时候是Windows下的文件事件触发了不在排除列表里的文件变更。

验证&解决步骤 #

你可以按下面的步骤排查：

• 检查DevTools配置：打开application.properties/application.yml，确认spring.devtools.restart.exclude包含static/**,public/**,resources/**，默认值是：

  spring.devtools.restart.exclude=META-INF/maven/**,META-INF/resources/**,resources/**,static/**,public/**,templates/**,**/*Test.class,**/*Tests.class,git.properties
  

  如果被自定义覆盖了，补全这些路径。
• 关闭自动编译：在Windows的IntelliJ里，关闭「Build project automatically」选项，然后修改静态文件试试，看是否还会重启。
• 强制排除静态资源：添加spring.devtools.restart.additional-exclude=static/**，手动强化排除规则，避免误触发。
• 检查target目录：修改静态文件后，查看target/classes目录，是否有.class文件或其他非静态文件的变化，如果有，说明是编译触发了重启。

内容的提问来源于stack exchange，提问作者Luís Soares