Spring Boot H2控制台WebServlet未自动注册：跨平台运行异常问询

这问题我之前帮同事排查过类似的，大概率是这几个细节差异导致的，咱们一个个来捋清楚：

1. H2控制台的环境配置限制 #

Spring Boot的H2控制台默认只在dev开发环境下自动启用，如果你的配置是分环境写的（比如application-dev.yml里开了控制台，主配置没开），那macOS下启动时可能没加载到dev环境。

你可以先检查启动日志里的环境标识，比如有没有The following profiles are active: dev的字样。如果没有，试试启动时手动指定环境：

java -jar demo.jar --spring.profiles.active=dev

或者直接把spring.h2.console.enabled=true写到主配置文件（比如application.yml/application.properties）里，让它在所有环境下都生效。

2. 端口或上下文路径的变化 #

有没有可能macOS下8080端口被其他程序占用了？Spring Boot会自动切换到可用端口，你可以看启动日志里的这行：Tomcat started on port(s): XXXX (http)，确认实际端口是不是8080。如果端口变了，访问地址要改成http://localhost:XXXX/h2。

另外，如果你的应用配置了server.servlet.context-path（比如设置了上下文路径为/demo），那H2控制台的访问路径会变成http://localhost:8080/demo/h2，别漏了上下文路径。

3. 自动配置的生效问题 #

虽然jar包是同一个，但可以看看H2控制台的自动配置有没有被跳过。启动时加--debug参数，打印详细的自动配置日志：

java -jar demo.jar --debug

然后在日志里搜索H2ConsoleAutoConfiguration，看看有没有ConditionalOnProperty matched: spring.h2.console.enabled is true这样的生效日志，还是ConditionalOnProperty did not match被跳过了。如果被跳过，那就是配置没开对。

4. 浏览器或代理的干扰 #

有时候浏览器缓存会导致旧路径的缓存残留，试试用无痕模式访问http://localhost:8080/h2，或者手动清除浏览器缓存。另外，macOS下如果开了全局代理，可能会拦截本地请求，先关掉代理再试试。

5. 少见的权限或类加载问题（概率低但值得排查） #

用lsof -i :8080命令检查下8080端口是不是你的demo.jar在占用，避免端口被其他程序抢了但你没注意到。另外，也可以用jar tf demo.jar | grep h2确认jar包里确实包含H2的依赖文件，排除打包时漏加依赖的情况。

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