当前位置： 首页 > news >正文

【SpringBoot】SpringBoot 纯后端项目如何自定义异常页面(Whitelabel Error Page)

news 2026/5/25 22:56:23

文章目录

  • 背景
  • 安排
    • 方案
    • 步骤
  • 验证

背景

  • 一个短链服务，业务将长链接给我，我转换成短地址，用户访问短地址时，我再做redirect；
  • 没有前端，纯后端项目
  • 短链会有过期时间，过期后将返回错误信息
  • 某一天一个宁静的下午，业务反馈，你这错误码，直接给用户看，不友好，麻烦弄一个404页面吧。

当前代码如下：当查询不到对应链接（过期、或者不存在）时，返回JSON格式的统一响应：

灵机一动，不需要JSON是吧，我直接返回404不就行了吗？于是稍作改动：

此时再访问，会跳转到默认的error页面，看起来是比一个JSON串友好，但是，这东西，除了咱们这些计算机科学家，大部分人也看不懂，还是不友好！！！

安排

方案

有三种方法可以解决眼下的问题：

  • 方法一：在配置文件中设置server.error.whitelabel.enabled为false，然后在controller中定义/error请求，返回自定义的内容。
  • 方法二：在项目中创建一个名为error的视图（如HTML或JSP文件），放在模板目录下（如src/main/resources/templates），然后SpringBoot会自动将错误请求转发到该视图。
  • 方法三：实现ErrorPageRegistrar接口，注册不同的错误页面，针对不同的HTTP状态码。
  • 方法四：搭一个nginx，作为404页面的静态资源服务器。

用户需求是返回一个好看的404页面，方法一排除；

项目是纯后端项目，方法二排除；

为一个页面搭一个nginx，不值当，方法四排除；

所以，选定方法三。

步骤

方法三的详细说明如下：

  • 首先，你需要创建一个配置类，实现ErrorPageRegistrar接口，这个接口有一个方法registerErrorPages，用于注册不同的错误页面。
  • 然后，你需要在registerErrorPages方法中创建一个ErrorPage数组，每个ErrorPage对象包含一个HttpStatus和一个路径，表示当发生该状态码的错误时，跳转到哪个路径。
  • 最后，你需要调用registry.addErrorPages(errorPages)方法，将错误页面数组注册到错误页面注册器中。

下面是一个示例代码：

@Configuration
public class ErrorCodePageHandler implements ErrorPageRegistrar {@Overridepublic void registerErrorPages(ErrorPageRegistry registry) {ErrorPage[] errorPages = new ErrorPage[2];// 添加错误页面进行映射errorPages[0] = new ErrorPage(HttpStatus.NOT_FOUND, "/404.html");errorPages[1] = new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/500.html");registry.addErrorPages(errorPages);}
}

html文件需要放在静态资源目录下（如src/main/resources/static），然后在该文件夹中创建一个名为404.html的文件，写上你想要显示的内容。

这样，当发生404错误时，SpringBoot会自动将请求转发到/404.html路径，显示你自定义的错误页面。

一个最简单的404.html：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>404 Not Found</title>
</head>
<body><h1>Oops!</h1><p>The page you are looking for does not exist.</p>
</body>
</html>

验证

项目结构：

页面效果：

当然，这个页面不是最终效果，会有专业的小姐姐提供优美的页面。

相关文章：

【SpringBoot】SpringBoot 纯后端项目如何自定义异常页面(Whitelabel Error Page)

文章目录 背景安排方案步骤 验证 背景 一个短链服务&#xff0c;业务将长链接给我&#xff0c;我转换成短地址&#xff0c;用户访问短地址时&#xff0c;我再做redirect&#xff1b;没有前端&#xff0c;纯后端项目短链会有过期时间&#xff0c;过期后将返回错误信息某一天一个…...

编程日记 2023/5/23 20:45:13

Netty核心技术三--NIO编程

1. JAVA NIO基本介绍 Java NIO 全称 java non-blocking IO&#xff0c;是指 JDK 提供的新API。从 JDK1.4 开始&#xff0c;Java 提供了一系列改进的输入/输出的新特性&#xff0c;被统称为 NIO(即 New IO)&#xff0c;是同步非阻塞的 NIO 相关类都被放在 java.nio 包及子包下&…...

编程日记 2023/5/23 20:40:10

机器人的运动范围：DFS

Problem: 剑指 Offer 13. 机器人的运动范围 文章目录 思路解题方法复杂度Code 思路 首先定义好地图&#xff0c;上下左右四个方向也就是{{1,0},{0,1},{-1,0},{0,-1}}&#xff0c;然后我们另外定义一个方法来判断题目要求的下标位数和是否大于k&#xff0c; boolean check(int x…...

编程日记 2023/5/23 20:35:07

Rshiny编写ui中具有web依赖项的控件{该问题的具体阐述请看引言}

Rshiny编写ui中具有web依赖项的控件{该问题的具体阐述请看引言} 引言conditionalPanel函数update*函数系列总结引言 问题说明：在汇报的过程中我们想添加具有web依赖项的控件，比如ui中有两个控件：第一个控件标签为m,其取值为：1、2；第二个控件标签为m0，m0的取值依赖于m，即…...

编程日记 2023/5/30 20:12:15

1700页，卷S人的 软件测试《八股文》PDF手册，涨薪跳槽拿高薪就靠它了

大家好&#xff0c;最近有不少小伙伴在后台留言&#xff0c;又得准备面试了&#xff0c;不知道从何下手&#xff01; 不论是跳槽涨薪&#xff0c;还是学习提升&#xff01;先给自己定一个小目标&#xff0c;然后再朝着目标去努力就完事儿了&#xff01; 为了帮大家节约时间&a…...

编程日记 2023/5/23 20:25:05

bundle的常用命令

Bundle 是 Ruby 的一个包管理器&#xff0c;用于管理 Ruby 应用程序所需的依赖项。下面是一些常用的 Bundle 命令&#xff1a; 以下是常用的 Bundle 命令&#xff1a; 1. bundle install&#xff1a;安装所有在 Gemfile 中列出的 gem 包及其依赖项。 2. bundle update&#x…...

编程日记 2023/5/23 20:19:58

一、数据字典介绍

文章目录 一、数据字典介绍1、页面效果2、表设计3、数据分析4、根据页面效果分析数据接口 一、数据字典介绍 何为数据字典&#xff1f;数据字典就是管理系统常用的分类数据或者一些固定数据&#xff0c;例如&#xff1a;省市区三级联动数据、民族数据、行业数据、学历数据等&a…...

编程日记 2023/5/23 20:14:57

常见的SQL优化

索引优化&#xff1a;通过创建合适的索引来加快查询速度。查询优化&#xff1a;使用合适的查询语句和查询条件&#xff0c;避免全表扫描。比如&#xff1a; 避免使用SELECT *避免使用子查询避免使用OR操作符避免使用LIKE操作符使用LIMIT限制结果集大小优化查询语句的顺序 数据库…...

编程日记 2023/5/23 20:09:50

Sonic新生态Sonic IDE体验

背景 Sonic:免费开源的云真机测试平台&#xff0c;用心打造更好的使用体验。 之前在做APP的日常测试和UI自动化的时候,一直在使用Sonic 没有切换到平台上进行自动化测试的原因是由于现有脚本框架已经成熟,并且有很多自定义的拓展,所以Sonic的更多是一个设备管理员的角色 在Soni…...

编程日记 2023/6/1 7:58:11

[VRTK4.0]安装VRTKv4Tilia软件包导入程序

学习目标&#xff1a; 演示如何从Unitv资源商店安装VRTKv4Tilia包导入器,以轻松访问VRTKv4Tilia包&#xff0c;这些包为构建XR体验提供了各种有用的功能. 简述&#xff1a; 推荐使用2022.2.11F1以上版本来进行VRTK使用&#xff0c;我们可以从Unity资产商店导入Tilia包管理器&am…...

编程日记 2023/5/23 19:59:47

SpringBoot开发实用篇2---与数据层技术有关的替换和整合

四、数据层解决方案 1.SQL 现有数据层解决方案技术选型&#xff1a;DruidMyBatis-plusMySQL 数据源&#xff1a;DruidDataSource 持久化技术&#xff1a;MyBatis-plus/MyBatis 数据库&#xff1a;MySql 内置数据源&#xff1a; SpringBoot提供了3种内嵌的数据源对象供开发者选…...

编程日记 2023/5/23 19:54:42

科普ChatGPT

ChatGPT是什么? ChatGPT是一款基于人工智能技术的聊天机器人&#xff0c;可以进行自然语言的交互。它是由OpenAI公司开发的&#xff0c;其名称中的GPT是“Generative Pre-trained Transformer”的缩写&#xff0c;即基于预训练的转换器。ChatGPT使用预训练的神经网络模型来理…...

编程日记 2023/5/23 19:49:40

Spring MVC的核心类和注解

DispatcherServlet DispatcherServlet作用 DispatcherServlet是Spring MVC的核心类&#xff0c;也是Spring MVC的流程控制中心&#xff0c;也称为Spring MVC的前端控制器&#xff0c;它可以拦截客户端的请求。拦截客户端请求之后&#xff0c;DispatcherServlet会根据具体规则…...

编程日记 2023/5/23 19:44:38

Java 创建一个大文件

有时候&#xff0c;我们在对文件进行测试的时候&#xff0c;可能需要创建一个临时的大文件。 那么问题来了&#xff0c;在 Java 中如何创建大文件呢&#xff1f; 问题和解决 有些人想到的办法就是定义一个随机的字符串&#xff0c;然后重复很多次&#xff0c;然后将这个字符…...

编程日记 2023/5/23 19:39:37

董小姐大意了

阅读本文大概需要 1.17 分钟。 董小姐跟孟羽童的事情&#xff0c;想必大家或多或少都听说了。 事情的经过我就不多做赘述了&#xff0c;实际上并不复杂。 董小姐不是善茬&#xff0c;孟年轻做不来事&#xff0c;不能给格力带来价值&#xff0c;那可以归为双方没缘分&#xff0c…...

编程日记 2023/5/23 19:34:35

Java高并发核心编程—内置锁原理篇

注&#xff1a;本笔记是阅读《Java高并发核心编程卷2》整理的笔记&#xff01; 导致并发修改的原因 基本概念 synchronized 关键字 方法声明synchronized synchronized 同步块 消费者生产者问题 Java对象结构与内置锁 四种内置锁 偏向锁原理 偏向锁的撤销 偏向锁的膨胀 全局安全…...

编程日记 2023/5/23 19:29:33

opencv文字识别

OpenCV&#xff08;开源计算机视觉库&#xff09;是一个用于实现计算机视觉和机器学习的开源库。它包含了许多预先训练的模型和算法&#xff0c;可以帮助开发者快速实现图像处理、对象检测和识别等功能。在文字识别方面&#xff0c;OpenCV也有一些实用的工具和方法。 要在OpenC…...

编程日记 2023/5/23 19:24:27

bool、python集合

目录 1、使用bool判断某一数据类型是否为空 2、Python集合&#xff08;数组&#xff09; 1、列表 2、元组 3、集合 4、字典 1、使用bool判断某一数据类型是否为空 如果有某种内容&#xff0c;则几乎所有值都将评估为 True。 除空字符串外&#xff0c;任何字符串均为 Tr…...

编程日记 2023/5/30 14:03:14

从零开始学架构——可扩展架构模式

可扩展架构模式的基本思想和模式 软件系统与硬件和建筑系统最大的差异在于软件是可扩展的&#xff0c;一个硬件生产出来后就不会再进行改变、一个建筑完工后也不会再改变其整体结构 例如&#xff0c;一颗 CPU 生产出来后装到一台 PC 机上&#xff0c;不会再返回工厂进行加工以…...

编程日记 2023/5/30 14:05:20

Day03 01-MySQL数据完整性详解

文章目录 第七章 数据完整性7.1 完整性约束7.2 实体完整性7.2.1 唯一约束7.2.2 主键约束7.2.3 自增约束 7.3 域完整性7.3.1 非空约束7.3.2 默认值约束7.3.3 检查约束 7.4 引用完整性 第七章 数据完整性 7.1 完整性约束 我们已经知道了如何创建数据库、如何创建表、如何在表中…...

编程日记 2023/5/23 19:09:22

基于C#实现（WinForm）P2P聊天程序

♻️ 资源 大小&#xff1a; 29.8MB ➡️ 资源下载&#xff1a;https://download.csdn.net/download/s1t16/87430269 p2p聊天程序 一、功能介绍 1.1 登录 用户凭用户名和密码登录系统&#xff0c;可以更换服务器 IP 和端口&#xff0c;以防网络不畅通&#xff0c;连接服务…...

编程新知 2026/5/25 18:03:50

GEP协议深度解读：AI智能体自我进化的基因工程

OpenAI 官宣全面支持MCP协议，标志着AI应用架构的"连接标准"已定。如果说MCP是AI时代的USB-C，解决了模型与工具的连接问题，那么GEP（Genome Evolution Protocol，基因组进化协议）则正在解决另一个更本质的问题——智能体的自我进化与生命周期管理。 作为下一代AI基…...

编程新知 2026/5/25 17:30:24

Windows键盘重映射终极指南：如何使用SharpKeys专业解决方案告别误触烦恼

Windows键盘重映射终极指南&#xff1a;如何使用SharpKeys专业解决方案告别误触烦恼 【免费下载链接】sharpkeys SharpKeys is a utility that manages a Registry key that allows Windows to remap one key to any other key. 项目地址: https://gitcode.com/gh_mirrors/sh…...

编程新知 2026/5/25 15:32:48

DRG存档编辑器终极指南：如何快速解锁《深岩银河》的全部游戏体验

DRG存档编辑器终极指南&#xff1a;如何快速解锁《深岩银河》的全部游戏体验 【免费下载链接】DRG-Save-Editor Rock and stone! 项目地址: https://gitcode.com/gh_mirrors/dr/DRG-Save-Editor 还在为《深岩银河》中无尽的资源收集和等级提升感到疲惫吗&#xff1f;DRG…...

编程新知 2026/5/25 15:09:50

D3KeyHelper终极指南：5分钟掌握暗黑3最强自动化工具

D3KeyHelper终极指南&#xff1a;5分钟掌握暗黑3最强自动化工具 【免费下载链接】D3keyHelper D3KeyHelper是一个有图形界面&#xff0c;可自定义配置的暗黑3鼠标宏工具。 项目地址: https://gitcode.com/gh_mirrors/d3/D3keyHelper D3KeyHelper是一款专为《暗黑破坏神3…...

编程新知 2026/5/25 14:47:35

PlayAI实时翻译如何重构跨国协作效率？揭秘2024企业级应用的3个关键转折点

更多请点击&#xff1a; https://codechina.net 第一章&#xff1a;PlayAI实时翻译如何重构跨国协作效率&#xff1f;揭秘2024企业级应用的3个关键转折点 在远程办公常态化与全球供应链深度耦合的背景下&#xff0c;PlayAI 实时翻译已从辅助工具跃升为协同基础设施。其核心突破…...

编程新知 2026/5/25 14:21:40

PagerLayoutManager：让Android网格分页布局实现变得简单高效的终极方案

PagerLayoutManager&#xff1a;让Android网格分页布局实现变得简单高效的终极方案 【免费下载链接】pager-layoutmanager [暂停维护]Android 网格分页布局。 项目地址: https://gitcode.com/gh_mirrors/pa/pager-layoutmanager PagerLayoutManager是一款专为Android开发…...

编程新知 2026/5/25 13:51:12

压测不只是加并发：我们模拟真实用户行为后，发现了隐藏瓶颈

在性能测试领域&#xff0c;一个根深蒂固的误解是&#xff1a;压测就是使劲加线程数&#xff0c;看系统什么时候崩。很多团队用 JMeter 起 500 个并发&#xff0c;照着接口列表跑一圈&#xff0c;看到 TPS 平稳、响应时间没超过 300ms&#xff0c;就觉得万事大吉。可一旦上线&a…...

编程新知 2026/5/25 13:41:53

Week1：机器学习入门

Week1&#xff1a;机器学习入门摘要&#xff1a;本周完成李宏毅《机器学习》课程第 1 讲的入门学习&#xff0c;建立对机器学习的整体认知。首先梳理了人工智能、机器学习与深度学习的层级关系&#xff0c;剖析了传统 “人工设定规则” 方法的局限性&#xff1b;在此基础上&…...

编程新知 2026/5/25 11:02:54

Lilishop：基于Spring Boot3的B2B2C开源商城系统全解析

引言在数字化转型浪潮席卷各行各业的今天&#xff0c;电商系统已成为企业拓展线上业务的核心基础设施。然而&#xff0c;从零构建一套功能完备、性能卓越、可扩展的商城系统&#xff0c;不仅需要投入大量研发资源&#xff0c;还面临技术选型、架构设计、安全合规等诸多挑战。开…...

编程新知 2026/5/25 10:14:20