ASP.NET Core:如何基于用户语言从注入服务获取嵌套JSON本地化数据
实现方案
核心原因澄清
你之前翻遍ASP.NET Core源码都找不到语言校验、资源匹配逻辑,本质是找错了位置:语言识别、当前文化赋值的逻辑根本不在本地化服务类内部,而是在请求管道的RequestLocalizationMiddleware中间件里完成。
这套内置机制会通过你配置的文化提供器(自动从请求头、Cookie、路由参数、查询参数里读取用户的语言偏好)解析出当前请求对应的CultureInfo,后续所有本地化组件只要读取当前线程的CurrentUICulture就能拿到正确的语言标识,完全不需要自己重复实现语言判断逻辑。
第一步:配置请求本地化基础管道
首先在项目的请求管道里配置好本地化的基础能力,注意中间件的注册顺序必须在Razor Pages、MVC这类渲染组件之前:
// 程序启动注册阶段 builder.Services.AddLocalization(); builder.Services.AddMemoryCache(); builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>(); // 配置支持的语言列表、默认语言 builder.Services.Configure<RequestLocalizationOptions>(options => { var supportedCultures = new[] { new CultureInfo("en"), new CultureInfo("ru") }; options.DefaultRequestCulture = new RequestCulture("en"); options.SupportedCultures = supportedCultures; options.SupportedUICultures = supportedCultures; }); // 管道注册阶段,必须在UseRouting之后、UseEndpoints之前 app.UseRequestLocalization(); app.UseEndpoints(endpoints => endpoints.MapRazorPages());
第二步:实现支持嵌套JSON键的自定义本地化服务
按照需要的使用体验(单例注入、支持链式嵌套索引取值、自动加载对应语言JSON)编写服务实现,核心要做的几个能力:
- 支持链式索引的嵌套取值,不需要把JSON键打平成字符串路径
- 自动根据当前请求的语言读取对应JSON文件
- 加内存缓存避免每次请求都重复读文件、解析JSON
- 加文件变更监控,JSON文件修改后自动更新缓存不需要重启站点
public class JsonLocalizationService { private readonly IWebHostEnvironment _env; private readonly IHttpContextAccessor _httpContextAccessor; private readonly IMemoryCache _cache; // 索引器支持链式调用:JsonLocalizationService["key1"]["key2"] public JsonLocalizationSection this[string key] => new JsonLocalizationSection(GetCurrentLanguageData(), key); public JsonLocalizationService(IWebHostEnvironment env, IHttpContextAccessor httpContextAccessor, IMemoryCache cache) { _env = env; _httpContextAccessor = httpContextAccessor; _cache = cache; } private JObject GetCurrentLanguageData() { // 直接取内置中间件解析好的当前UI语言 var currentLang = CultureInfo.CurrentUICulture.TwoLetterISOLanguageName; var cacheKey = $"json_loc_cache_{currentLang}"; // 命中缓存直接返回 if (_cache.TryGetValue<JObject>(cacheKey, out var cachedData)) return cachedData; // 按约定路径读取对应语言的JSON文件,比如Locales/file.en.json var filePath = Path.Combine(_env.ContentRootPath, "Locales", $"file.{currentLang}.json"); var jsonContent = File.ReadAllText(filePath); var parsedData = JObject.Parse(jsonContent); // 设置缓存,绑定文件变更监控,文件修改时自动失效缓存 var changeToken = _env.ContentRootFileProvider.Watch(filePath); _cache.Set(cacheKey, parsedData, new CachingChangeToken(changeToken)); return parsedData; } } // 辅助类,专门用来实现嵌套链式的索引取值 public class JsonLocalizationSection { private readonly JToken _currentNode; private readonly string _currentKey; public JsonLocalizationSection(JObject root, string initialKey) { _currentNode = root[initialKey]; _currentKey = initialKey; } private JsonLocalizationSection(JToken node, string key) { _currentNode = node; _currentKey = key; } // 支持继续取嵌套层级的下一个节点 public JsonLocalizationSection this[string nextKey] => new JsonLocalizationSection(_currentNode?[nextKey], nextKey); // Razor渲染时自动调用ToString输出最终的本地化文本 public override string ToString() => _currentNode?.ToString() ?? $"未找到键:{_currentKey}"; }
最后把这个服务注册成单例即可:
builder.Services.AddSingleton<JsonLocalizationService>();
第三步:实际使用效果
在Razor页面里直接按照预期的写法调用,不需要额外适配:
@inject JsonLocalizationService JsonLocalizer <!-- 英文用户访问时输出 Hello,俄文用户访问时输出 Привет --> <p>@JsonLocalizer["nested"]["item"]</p>
避坑提醒
- 单例服务千万不能直接注入Scoped生命周期的
HttpContext,必须通过IHttpContextAccessor获取当前请求的上下文,否则会出现跨请求的语言数据串用问题。 - 不要重复造轮子实现语言识别逻辑,直接复用内置的
RequestLocalizationMiddleware即可,这套机制已经覆盖了请求头、Cookie、路由、查询参数等全场景的语言识别,自己实现很容易遗漏边界情况。 - 不需要把JSON的嵌套键打平成类似
"nested:item"的字符串路径,通过自定义的JsonLocalizationSection类实现链式索引,既能保留原JSON的结构可读性,也能达到和预期完全一致的调用体验。
内容的提问来源于stack exchange,提问作者The Neighbors Kid
相关产品推荐
相关产品推荐

