使用knife4j时报错Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is java.lang.NullPointerException] with root cause

在使用 Knife4j 时，如果遇到 `Servlet.service() for servlet [dispatcherServlet] threw exception: Request processing failed; nested exception is java.lang.NullPointerException` 错误，通常表明某个组件在请求处理过程中未能正确初始化或配置，导致访问接口文档页面时触发了空指针异常。 ### 可能原因及解决方法 1. **未正确配置 Knife4j 的静态资源映射** Spring Boot 默认只从 `classpath:/static/` 和 `classpath:/public/` 加载静态资源。Knife4j（基于 Swagger UI）的前端页面属于动态生成的静态资源，若未进行特殊配置，Spring Boot 会将其视为普通接口请求并尝试匹配控制器，从而导致 404 或 `NullPointerException`。 应在配置类中添加如下资源映射代码以确保 Knife4j 页面正常加载： ```java @Configuration public class Knife4jConfig { @Bean public WebMvcConfigurer webMvcConfigurer() { return new WebMvcConfigurer() { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("doc.html") .addResourceLocations("classpath:/META-INF/resources/"); registry.addResourceHandler("/webjars/**") .addResourceLocations("classpath:/META-INF/resources/webjars/"); } }; } } ``` 2. **未正确引入 Knife4j 的 Maven 依赖** 确保在 `pom.xml` 中已正确导入 Knife4j 的坐标，例如： ```xml <dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> ``` 若版本不兼容或遗漏该依赖，可能导致 Knife4j 功能无法正常启动，进而引发运行时错误[^3]。 3. **接口参数未正确设置默认值导致解析失败** 在某些情况下，若接口定义中使用了 `@RequestParam` 注解但未指定 `defaultValue`，而参数本身又为非必需 (`required = false`)，则可能因参数解析失败而导致 `NullPointerException`。例如以下写法可能会出现问题： ```java @GetMapping("/test") public String test(@RequestParam(value = "addAllStrike", required = false) Boolean addAllStrike) { // 如果未传参且未设 defaultValue，则 addAllStrike 为 null，后续逻辑可能抛出 NullPointerException } ``` 建议修改为： ```java @GetMapping("/test") public String test(@RequestParam(value = "addAllStrike", required = false, defaultValue = "false") Boolean addAllStrike) { // 设置默认值后，addAllStrike 不会为 null } ``` 4. **Spring Boot 版本与 Knife4j 不兼容** 某些旧版 Spring Boot（如 2.3.x）可能与最新版本的 Knife4j 存在兼容性问题。建议升级 Spring Boot 至较新版本（如 2.6.x 或更高），或根据 Knife4j 官方文档选择适配的版本[^4]。 5. **Swagger 接口注解缺失或配置错误** Knife4j 是基于 Swagger 的增强工具，若接口未正确使用 `@Api`、`@ApiOperation` 等注解，或者配置类中未启用 Swagger（如缺少 `@EnableSwagger2`），也可能导致 Knife4j 初始化失败并抛出异常。 正确启用方式示例： ```java @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")) .paths(PathSelectors.any()) .build(); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("API 文档") .description("Knife4j 接口文档说明") .version("1.0") .build(); } } ``` ---