错误页面与错误信息
校对日期:2026-11-16。适用于社区版及全部商业版。
本页说明前台出错时访客看到什么、错误页面的模板在哪里、怎样根据错误编号找到日志,以及相关配置项为什么应保持默认。
一、谁能看到什么
出错时显示多少信息,取决于谁在看,而不是运行环境:
| 访问者 | 看到的内容 |
|---|---|
| 普通访客 | 通用的错误页面和一个 8 位的错误编号,不显示具体的错误信息 |
| 已登录后台的操作员 | 错误详情。模板出错时,详情直接显示在页面上出错的位置,页面其余部分照常显示 |
访客反馈问题时,请对方提供页面上的错误编号,在程序日志里搜索这个编号即可找到对应的完整错误; 模板引起的错误还可以在后台 设计 → 模板管理 → 最近错误 里查看。模板错误的排查方法见模板编写的“运行时模板错误与错误编号”一节。
二、错误页面的模板
错误页面有独立的一组模板,不属于任何站点的主题,所有站点共用:
| 部署方式 | 位置 |
|---|---|
| Jar | static/ |
| Tomcat | webapps/ |
| Docker | /ujcms/ |
| 源码 | ujcms-starter/ |
| 文件 | 用于 |
|---|---|
404.html、403.html、400.html | 对应的状态码 |
4xx.html | 其它 4 开头的状态码 |
500_status.html、503_status.html、5xx.html | 服务器错误 |
site_ | 站点已关闭 |
需要自定义错误页面时直接修改这些文件。升级时注意保留:Jar 和 Tomcat 部署按升级的说明保留 themes/ 目录即可; Docker 部署时这个目录在数据卷里,换镜像不会覆盖它,但如果开启了 UJCMS_,它会被镜像里的版本覆盖。
三、相关配置项
application. 里有三个与错误信息有关的配置项,保持默认值即可:
yaml
server.error.include-exception: true
server.error.include-message: always
server.error.include-stacktrace: never- 前两项不要关闭。后台界面依靠它们区分错误类型并显示提示(如“没有权限”“数据已被引用,不能删除”),关闭后后台的错误提示会变得无法理解。 访客看不到其中的敏感内容:对未登录的访问者,服务器错误的具体信息已经由程序隐去。
include-stacktrace不要改为always。错误堆栈不区分访问者,改了以后所有人都能在错误页面上看到堆栈。