404必须为原生HTML文本,不可用图片、SVG或JS生成,否则网络中断、脚本禁用或CSP拦截时错误信息将不可见;它是搜索引擎判断页面意图和屏幕阅读器播报错误类型的首要语义信号。

404页面不是“写个带404字样的HTML就行”,核心是结构必须让浏览器、爬虫和屏幕阅读器一眼认出这是错误页——必须存在且不可被图片、SVG或JS替换,否则可访问性与SEO直接失效。404
为什么404
不能用图片或JS生成
404
当网络中断、JS加载失败或用户禁用脚本时,只有原生HTML能保证错误信息可见。用或
document.write("404"),会导致页面空白或语义丢失。
-
是搜索引擎判断页面意图的首要信号,缺失则可能被当作普通内容页收录 - 屏幕阅读器靠
播报页面类型,没有它,视障用户无法第一时间确认发生了什么错误 - 部分CDN或CSP策略会拦截未声明
integrity的内联脚本,<script>document.write(location.pathname)</script>可能直接不执行
和这些语义标签真有必要?
有必要,而且是硬性要求。它们不是“锦上添花”,而是告诉辅助技术“哪块是错误主体”“哪块是操作出口”。
-
包裹错误说明和返回链接,避免导航栏、侧边栏等干扰内容混入主逻辑流 -
放返回首页链接时,应配rel="nofollow",防止爬虫误认为这是正常导航路径 - 不用替代
——前者无语义,后者在DOM树中自带role="main"路径引用必须用根相对路径
/css/style.css,不能用./css/style.css因为404可能发生在任意子路径下,比如
/blog/2024/post/xxx,此时./指向的是/blog/2024/post/,而不是网站根目录。- 所有资源引用(CSS、字体、SVG)都得以
/开头,例如 - 内联
最稳妥,避免外部CSS请求失败导致白屏;若必须外链,确保服务器对/style.css也返回200 - 图标类SVG建议直接内联,而非
——多一次HTTP请求就多一次404风险
别用
自动跳转它会让服务器返回200状态码,彻底废掉404的语义和SEO价值,且对屏幕阅读器不友好。
- 用户可能刚读到“页面未找到”,页面就突然跳走,造成认知断层
- 跳转目标如果是
index.html,需确保该文件真实存在且可访问,否则引发二次404 - 真正安全的返回方式只有两种:
@#@#@#@#@#@#@#@#@#@0或(后者需降级为兼容旧环境)
最容易被忽略的一点:404页面本身必须由服务器返回真实的
404 Not Found状态码和Content-Type: text/html响应头。光有404.html文件但返回200,等于没做。静态托管平台(如GitHub Pages)默认支持,但自建Nginx/Apache或后端服务(如Express)必须显式配置,否则一切结构都白搭。 - 所有资源引用(CSS、字体、SVG)都得以
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











