Spring Boot整合Keycloak教程无法运行，求排查问题

看起来你跟着2017年的老教程操作，踩了几个版本适配和配置的坑，我帮你逐个分析解决：

1. 找不到index.html #

这个问题大概率和静态资源位置或视图依赖缺失有关：

• 如果你用的是Thymeleaf模板（老教程常用），要确保index.html放在src/main/resources/templates目录下，而不是static；同时必须引入spring-boot-starter-thymeleaf依赖，不然Spring Boot无法识别视图文件。
• 检查application.properties里的server.servlet.context-path配置，如果设置了前缀，访问时要加上这个前缀（比如配置了/app，就得访问http://localhost:8080/app/index.html）。
• 确认Spring Boot版本：2.x+之后的静态资源规则和1.x略有不同，别把文件放错目录。

2. 内部页面链接提示「Page not found」 #

可能的原因有两个：

• Keycloak拦截规则冲突：老教程的Security配置可能把内部页面路径也加入了拦截范围，导致未登录时无法访问，或者拦截规则写法不符合新版本Spring Security的规范。检查你的SecurityConfig类，确保内部页面路径（比如/products）被允许访问（用permitAll()），或者正确配置了Keycloak的保护规则。
• 路径映射错误：控制器的@RequestMapping注解路径和页面链接的路径不匹配，比如链接写的是/products，但控制器映射的是/product，或者相对路径写法错误（比如页面里用了<a href="products">而不是<a href="/products">）。

3. Circular view path [products] 错误 #

这是Spring MVC经典的视图解析循环问题：
当控制器返回的视图名称（比如return "products"）和请求的URL路径（/products）完全一致，而没有配置视图前缀/后缀时，Spring会误以为要把请求再次转发到/products，形成循环。
解决办法：

• 确保引入了spring-boot-starter-thymeleaf依赖，Spring Boot会自动配置前缀为classpath:/templates/、后缀为.html，这样返回"products"就会对应templates/products.html。
• 如果手动配置视图解析器，要在application.properties里添加：

  spring.thymeleaf.prefix=classpath:/templates/
  spring.thymeleaf.suffix=.html
  

4. 显示Keycloak管理面板而非示例应用 #

90%是端口冲突！Keycloak默认端口是8080，Spring Boot默认也是8080，你启动两个服务时，其中一个会抢占端口：

• 如果你先启动了Keycloak，再启动Spring Boot，Spring Boot可能启动失败，此时你访问8080自然看到的是Keycloak面板。
• 解决办法很简单：修改Spring Boot的端口，在application.properties里加一行：

  server.port=8081
  

  之后访问http://localhost:8081就能看到你的应用了，Keycloak继续用8080即可。

额外提醒：版本适配问题 #

2017年的教程用的是非常旧的Spring Boot和Keycloak版本，现在Keycloak已经升级到Quarkus架构（17+版本），Spring Boot也到了3.x，旧的整合方式（比如keycloak-spring-boot-starter）可能已经不兼容。如果上面的方法都没用，建议检查依赖版本，改用最新的OAuth2整合方式来对接Keycloak。

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