Wicket与Spring Boot自动配置失效问题排查

针对你遇到的MarkupNotFoundException错误，可从以下几个方向排查修复：

• 检查页面类与HTML文件的路径匹配
  Wicket严格要求页面类和对应HTML文件在同一包路径下，且文件名完全一致（大小写也要匹配，比如HomePage.java对应HomePage.html）。如果是Maven项目，HTML文件需放在src/main/resources/com/example/demo/目录下（与Java类的包结构对应），同时确保Maven打包时会将这些HTML文件纳入输出目录。

• 验证HTML文件的Wicket命名空间与结构
  HTML根标签必须声明Wicket命名空间，且页面内容区域需符合Wicket解析规则，示例如下：

  <html xmlns:wicket="http://wicket.apache.org">
    <body>
      <!-- 页面内容 -->
    </body>
  </html>
  

  同时要确保HTML文件无语法错误（比如未闭合标签），这类问题也会导致Wicket无法解析标记。

• 确认Spring Boot启动类的组件扫描范围
  如果HomePage类不在@SpringBootApplication启动类的子包下，需手动添加@ComponentScan指定扫描路径，示例：

  @SpringBootApplication
  @ComponentScan(basePackages = {"com.example.demo"})
  public class WicketDemoApplication {
      public static void main(String[] args) {
          SpringApplication.run(WicketDemoApplication.class, args);
      }
  }
  

• 检查页面类的继承与构造函数
  确保HomePage正确继承自WebPage，且构造函数符合Wicket规范（至少保留无参构造或带IModel参数的构造），示例：

  package com.example.demo;
  
  import org.apache.wicket.markup.html.WebPage;
  
  public class HomePage extends WebPage {
      public HomePage() {
          // 页面组件初始化逻辑
      }
  }
  

• 核对Maven依赖配置
  确保pom.xml中引入了正确的wicket-spring-boot starter依赖，避免版本冲突，示例：

  <dependency>
      <groupId>com.github.marcgiffing</groupId>
      <artifactId>wicket-spring-boot-starter</artifactId>
      <version>对应版本号</version>
  </dependency>
  

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