WebGoat 多语言完整指南：3 种方法切换语言并解决中文界面问题
WebGoat 多语言完整指南3 种方法切换语言并解决中文界面问题【免费下载链接】WebGoatWebGoat is a deliberately insecure application项目地址: https://gitcode.com/GitHub_Trending/we/WebGoat打开 WebGoat满屏英文的课程名和任务描述一行行啃正文体验确实糟糕。这篇文章带你摸清 WebGoat 多语言支持的全部家底官方到底支持哪几种语言、语言切换的 3 种实操路径、背后的 Spring 国际化机制以及 WebGoat 中文界面的两条现实出路读完即可上手。能力全景WebGoat 官方支持哪些语言根据当前版本源码src/main/resources/i18n目录下有 5 个翻译资源文件主页顶部的语言下拉菜单也对应给出 5 个入口语言资源文件覆盖范围en 英语messages.properties全部标签de 德语messages_de.properties界面主标签fr 法语messages_fr.properties界面主标签nl 荷兰语messages_nl.properties界面主标签es 西班牙语messages_es.properties界面主标签 一个容易被忽略的细节翻译只覆盖界面标签按钮、导航、提示。课程正文是 AsciiDoctor 的.adoc文件非英文课程默认只提供英文正文所以切换语言后课程内容仍是英文。中文zh目前不在官方支持范围内这是基于源码的事实陈述。这里有个小细节你可能会感兴趣静态资源目录里已经存在cnlang.svg这个中文国旗素材但对应的翻译文件和切换入口都还没做相当于留了个半成品。实操演练三种语言切换路径由易到难路径一浏览器语言偏好自动识别零配置WebGoat 的默认行为是跟随浏览器的Accept-Language请求头选语言把浏览器首选语言设为已支持的语言如法语fr新开一个会话确保 session 尚未建立语言记录登录并进入/WebGoat/start.mvc主页面验证右上角语言旗标变为对应语言顶部导航文案同步变化如果浏览器语言不在支持列表内比如中文会自动回退到英文界面不会出现半翻译的混乱状态。路径二URL 参数强制指定语言登录状态下给主页面地址加上lang参数即可强制切换登录后访问/WebGoat/start.mvc在地址后追加参数例如/WebGoat/start.mvc?langde页面刷新并自动跳回 Introduction 介绍页验证顶栏文案已变为德语课程菜单标题同步变化注意参数名必须是lang这是后端配置里写死的写错成language或其他形式都会无效。路径三Session 级下拉菜单持久切换WebGoat 使用SessionLocaleResolver你的语言选择会被记录在服务端 session 中登录后点击主页顶部的语言下拉菜单从 5 种语言里选择目标语言切换后自动回到 Introduction 页面验证连续跳转几个页面语言全程保持不变但持久仅限于当前会话session 过期或关闭浏览器后语言会重置。如果你希望设置跨浏览器重启也生效需要把解析器换成CookieLocaleResolver——这属于本地改造见下文机制部分。机制速览语言切换背后是怎么跑的先看一张组件关系图整个 WebGoat 国际化配置就这条链核心配置位于src/main/java/org/owasp/webgoat/container/MvcConfiguration.javaBean public LocaleResolver localeResolver() { SessionLocaleResolver localeResolver new SessionLocaleResolver(); return localeResolver; }Bean public LocaleChangeInterceptor localeChangeInterceptor() { LocaleChangeInterceptor lci new LocaleChangeInterceptor(); lci.setParamName(lang); return lci; }白话解读SessionLocaleResolver像个选词官它自己不翻译内容只负责记住当前该用哪本词典存在 session 里LocaleChangeInterceptor是守在请求入口的开关发现lang参数就更新这个选择。Language类src/main/java/org/owasp/webgoat/container/i18n/Language.java把解析器包了一层让Messages组件按classpath:i18n/messages这个前缀加载对应语言文件——这就是 WebGoat locale 解析链的全貌三处源码值得自行翻一遍上述配置类、Language.java、src/main/resources/i18n/资源目录。中文支持的两条现实路径两条路径适用人群不同能碰源码的读者走官方贡献一劳永逸纯使用者用浏览器插件临时汉化五分钟见效。贡献路径参与 WebGoat 翻译贡献流程按项目自带的README_I18N.md规范走需要创建或修改的文件起点模板实际需翻译messages.properties里的全部标签有数十条welcome欢迎使用 WebGoat login.username用户名 login.password密码 lesson.sql.titleSQL 注入 lesson.xss.title跨站脚本攻击⚠️ 集成测试LabelAndHintIntegrationTest会检查翻译是否漏项跑不过mvn clean的翻译 PR 是没法合入的本地先把测试跑绿。临时汉化路径浏览器插件代劳不想碰源码的读者最快的方式是浏览器翻译插件Chrome 可装沉浸式翻译Edge 自带网页翻译选择仅翻译文本模式避免图片、代码块被翻译后布局错乱排除 URL 地址栏和表单字段名的翻译防止干扰实际操作WebGoat 的界面标签稳定且重复率高把 Welcome、Lesson、Submit 等几个词加入自定义词典体验就够用了。高频问题速查现象根因处理动作lang参数无效参数名写错或请求未走拦截器确认参数是lang且指向主页面地址重启后语言重置SessionLocaleResolver仅会话内持久重新登录后再切换或改用CookieLocaleResolver顶栏翻译了课程正文仍英文课程 adoc 无对应语言版本预期行为按 README_I18N 步骤 5 翻译课程切换后整页变英文目标语言资源文件缺失或条目不全检查对应.properties文件完整性如果以上都没解决建议到项目 Issue 区搜索相同报错关键词。接下来你可以做什么普通使用者URL 参数加浏览器翻译插件组合使用五分钟搭好可用环境贡献者新建messages_zh.properties先翻译README_I18N.md第 4 步的核心标签mvn clean自测通过后提 PR完成一次 WebGoat 翻译贡献企业培训场景fork 仓库本地部署替换为CookieLocaleResolver并补齐翻译文件搭一套稳定的中文教学环境本文基于 WebGoat 当前版本源码在 Linux 环境下验证编写【免费下载链接】WebGoatWebGoat is a deliberately insecure application项目地址: https://gitcode.com/GitHub_Trending/we/WebGoat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考