HTML国际化怎么通过中间件拦截语言请求?

阿强大大_8268

阿强大大_8268

2026-07-22

625人浏览

原创

spring mvc拦截器通过解析url参数(如lang=zh_cn)、cookie或请求头识别语言,设置locale并注入视图上下文,不修改html响应体,仅透传语言标识供模板引擎或前端使用。

html国际化怎么通过中间件拦截语言请求?

Spring MVC 拦截器怎么识别并切换语言请求

HTML 页面本身没有中间件概念,所谓“通过中间件拦截语言请求”,实际是指后端(如 Spring MVC)用拦截器统一处理带语言标识的请求,并据此动态加载对应语言资源或路由。关键不是拦截 HTML,而是拦截 HTTP 请求头、URL 参数或 Cookie 中的语言线索。

常见错误现象:Accept-Language 被直接当作最终语言码使用(比如取 zh-CN 就直接加载 zh-CN.json),结果用户选了繁体中文却 fallback 到简体;或者拦截器没区分静态资源路径,把 /static/js/app.js 也扔进语言逻辑里,徒增开销。

  • 优先检查 URL 参数 lang=ja → 再查 Cookie 中的 preferred-lang → 最后 fallback 到 request.getLocale()(它比 navigator.language 更可靠,因由服务器解析 Accept-Language)
  • 拦截器必须排除静态资源路径:正则匹配 ^/(css|js|images|fonts)/ 或配置 mvc:resources 使其不进入拦截链
  • 不要在拦截器里做 JSON 语言包读取或渲染——那是前端职责;拦截器只负责设置语言上下文(如往 Model 放 lang 值,或往 HttpServletRequest attribute 中存 currentLang)
  • 若配合数据库多语言数据源(如中英文分库),拦截器可在此刻切换 DataSource,但需确保事务和连接池兼容

拦截器如何把语言信息透传给前端 HTML

光在后端识别语言不够,前端 HTML 必须拿到这个决策结果,才能正确加载语言包、设置 document.documentElement.lang、触发 data-i18n 渲染。不能靠 JS 再去查 navigator.language,那会和后端不一致。

使用场景:SSR 场景下首屏直出多语言内容,或前后端分离时需让前端知道服务端最终选定的语言码。

Doc To HTML
Doc To HTML

使用 MinerU 文档处理引擎将 Word 文档(.doc、.docx)转换为保留结构和格式的干净 HTML。

下载
  • 方案一(推荐):后端在响应 HTML 时,注入一个全局变量,例如
    <script>window.__LANG__ = "zh-Hans";</script>
    ,前端初始化 i18n 时优先读它
  • 方案二:通过 直接写死根节点 lang,同时在 上加 data-lang="zh-Hans" 供 JS 读取
  • 方案三(慎用):返回 HTTP 响应头 X-Content-Language: zh-Hans,前端用 fetch() 读 header —— 但普通 HTML 加载不会触发 fetch,仅适用于 AJAX 场景
  • 绝对避免:用 document.cookie 写语言码再让 JS 读取,Cookie 有大小限制且可能被禁用

为什么不能在拦截器里直接改 HTML 响应体

有人想在拦截器的 afterCompletion 里用正则替换响应 HTML 中的文字,这是高危操作。HTML 不是纯文本,DOM 结构、注释、<script></script> 内容、CDN 路径都可能被误伤。

性能影响明显:每次响应都要流式读取、字符串替换、重写输出流,吞吐量直接掉 30%+;更严重的是,GZIP 压缩后的 HTML 无法直接正则替换,必须先解压再压,CPU 爆满。

  • 真正该做的,是让拦截器把语言信息交给视图层(Thymeleaf / JSP / FreeMarker),由模板引擎在渲染时插入对应语言包键名,例如 <h1 th:text="#{home.welcome}"></h1>
  • 如果用纯静态 HTML + 前端 i18n,拦截器只需确保返回的 HTML 中包含正确的 window.__LANG__ 和 lang 属性,其余交给前端 JS
  • 若强行修改响应体,遇到 <textarea>含<script>标签</script></textarea> 这类结构,正则必挂,且 XSS 风险陡增

前端 JS 怎么和后端拦截器协同避免语言错乱

最大的坑是前后端语言决策不同步:后端选了 ja,前端却因为 localStorage 里残留的 en 又切回英文,页面一半日文一半英文。

容易被忽略的地方:切换语言时,前端发请求告诉后端新选择,后端拦截器要同步更新 Cookie 或 Session,否则刷新页面就回退;但这个请求本身又得带当前语言上下文,否则拦截器不知道该存哪个。

  • 前端语言切换按钮点击后,先发 POST 到 /api/lang,body 含 {"lang": "ja"},后端拦截器在此接口里写入 Cookie 并返回成功
  • 然后前端再执行 location.reload(),让拦截器在新请求中读到刚写的 Cookie,完成闭环
  • 不要用 GET 请求改语言(如 /setlang?lang=ja),既不安全也不符合 REST,还容易被爬虫误刷
  • 所有 AJAX 请求(包括语言包 fetch('/locales/ja.json'))应带上当前语言标识,比如加请求头 X-Request-Language: ja,方便后端日志追踪和灰度发布

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

spring mvc html

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5095

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

2972

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2610

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2659

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4599

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2601

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2389

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2188

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2148

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Symfony教程(入门篇+基础篇)
Symfony教程(入门篇+基础篇)

共18课时 | 1.8万人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.2万人学习

GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习