SpringBoot自定义404页面无法渲染API数据问题求助

核心问题排查 #

你的System.out.println无输出，说明自定义ErrorController的处理方法根本没被执行，这是Thymeleaf无法渲染数据的根本原因。先从以下几点逐一排查：

1. 确认ErrorController的实现规范 #

确保控制器类满足以下要求：

• 类上标注@Controller（不要用@RestController，否则会直接返回字符串而非视图）
• 处理方法的@RequestMapping路径为/error（Spring Boot默认错误请求都会转发到这个路径）
• Spring Boot 2.3+版本无需重写getErrorPath()方法，旧版本需重写该方法返回"/error"

正确的基础实现示例：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.boot.web.servlet.error.ErrorController;

@Controller
public class CustomErrorController implements ErrorController {

    @RequestMapping("/error")
    public String handleError(Model model) {
        model.addAttribute("joke", "Hello World!");
        System.out.println("错误控制器方法已执行");
        return "error"; // 返回视图名称，对应templates下的error.html
    }
}

2. 检查Thymeleaf视图配置 #

• 确保error.html放在src/main/resources/templates/目录下（Thymeleaf默认视图文件位置）
• 页面正确引入Thymeleaf命名空间，且正确使用th:text渲染模型数据：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>404 - 页面不存在</title>
</head>
<body>
    <h1>404 Oops!</h1>
    <p th:text="${joke}">默认笑话文本</p>
</body>
</html>

3. 依赖与配置检查 #

• 确认pom.xml（Maven）或build.gradle（Gradle）中引入了Thymeleaf Starter依赖：
  Maven：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

Gradle：

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

• 确保application.properties配置正确：

server.error.whitelabel.enabled=false
server.error.path=/error # 显式指定错误请求路径，确保转发到自定义控制器

接入Chuck Norris API的正确方式 #

当确认控制器方法能正常执行后，再接入API获取笑话：

1. 定义RestTemplate Bean #

在配置类中创建RestTemplate实例，用于调用外部API：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;

@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

2. 在ErrorController中调用API #

注入RestTemplate，调用API并将数据传入模型：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.web.client.RestTemplate;

@Controller
public class CustomErrorController implements ErrorController {

    private final RestTemplate restTemplate;

    @Autowired
    public CustomErrorController(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    @RequestMapping("/error")
    public String handleError(Model model) {
        try {
            // 调用Chuck Norris随机笑话API
            String apiUrl = "https://api.chucknorris.io/jokes/random";
            ChuckNorrisJoke jokeResponse = restTemplate.getForObject(apiUrl, ChuckNorrisJoke.class);
            model.addAttribute("joke", jokeResponse.getValue());
            System.out.println("已获取笑话：" + jokeResponse.getValue());
        } catch (Exception e) {
            // API调用失败时显示默认文本
            model.addAttribute("joke", "抱歉，暂时无法获取笑话~");
            e.printStackTrace();
        }
        return "error";
    }

    // 用于解析API返回JSON的内部类
    private static class ChuckNorrisJoke {
        private String value;

        public String getValue() {
            return value;
        }

        public void setValue(String value) {
            this.value = value;
        }
    }
}

新手常见错误总结 #

• 误用@RestController：该注解会将返回值直接作为响应体，而非视图名称，必须用@Controller
• 视图文件路径错误：Thymeleaf默认只识别src/main/resources/templates/下的模板文件
• 未引入Thymeleaf依赖：导致Spring无法解析Thymeleaf语法，页面只会显示静态文本
• 错误路径未匹配：自定义控制器的@RequestMapping必须为/error，否则无法接收Spring Boot转发的错误请求

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