You need to enable JavaScript to run this app. ASP.NET Core:如何基于用户语言从注入服务获取嵌套JSON本地化数据
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 11:24:08