讲师中心 微信公众号
AI工具推荐 视频效率加速

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

阿强大大_8268

阿强大大_8268

发布时间:2026-07-22 07:45:40

|

625人浏览过

|

来源于php中文网

原创

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 时优先读它
  • 方案二:通过 <html lang="zh-Hans"> 直接写死根节点 lang,同时在 <body> 上加 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> 内容、CDN 路径都可能被误伤。

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

  • 真正该做的,是让拦截器把语言信息交给视图层(Thymeleaf / JSP / FreeMarker),由模板引擎在渲染时插入对应语言包键名,例如 <h1 th:text="#{home.welcome}"></h1>
  • 如果用纯静态 HTML + 前端 i18n,拦截器只需确保返回的 HTML 中包含正确的 window.__LANG__ 和 lang 属性,其余交给前端 JS
  • 若强行修改响应体,遇到 <textarea>含<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,方便后端日志追踪和灰度发布

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

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

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

5075

2023.06.14

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

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

2952

2023.06.21

html网页制作
html网页制作

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

2610

2023.07.31

html空格
html空格

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

2639

2023.08.01

html是什么
html是什么

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

4599

2023.08.11

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

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

2601

2023.08.11

html转txt
html转txt

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

2369

2023.08.31

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

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

2168

2023.09.01

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn