MAUI应用运行时切换语言失效问题排查

问题描述 #

在MauiProgram.cs中实现了SetAppLanguage函数，应用默认以英文启动正常；通过设置页修改语言并写入settings.json后，重启应用可正常生效。但在登录页添加会话级语言切换功能时，触发调用SetAppLanguage后调试显示文化信息已变更，导航到其他页面后CultureInfo相关值又自动变回英文，导致数据解析失败。已尝试重置MainPage无效，怀疑与线程相关。

相关代码 #

SetAppLanguage函数 #

public static void SetAppLanguage(string appLanguagesCurrent)
{
    CultureInfo culture = new("en-US");
    if (appLanguagesCurrent == "English")
    {
        Commons.Language = "en";
    }
    else if (appLanguagesCurrent == "Română")
    {
        Commons.Language = "ro";
        culture = new("ro-RO");
    }

    Thread.CurrentThread.CurrentCulture = culture;
    Thread.CurrentThread.CurrentUICulture = culture;
    CultureInfo.CurrentCulture = culture;
    CultureInfo.DefaultThreadCurrentCulture = culture;
    CultureInfo.DefaultThreadCurrentUICulture = culture;
}

登录页切换语言代码 #

private async Task SwitchLanguage(string language)
{
    //By default the language is set in the Settings page. However, we can switch it here for this session.
    CultureInfo switchToCulture;
    if (language == "EN")
    {
        Commons.Language = "en";
        Globals.AppSettings.Language = "English";
        switchToCulture = new("en-US");
    }
    else
    {
        Commons.Language = "ro";
        Globals.AppSettings.Language = "Română";
        switchToCulture = new("ro-RO");
    }

    MauiProgram.SetAppLanguage(Globals.AppSettings.Language);
    GlobalLocalizationResourceManager.SetCulture(switchToCulture);
}

问题原因分析 #

1. 已加载页面的本地化绑定未刷新：切换语言时仅修改了线程文化，但之前加载的页面绑定的本地化资源未触发更新，导致页面显示和后续解析仍使用旧文化。
2. 后台线程文化未同步：如果数据解析逻辑运行在切换语言前创建的后台线程，该线程的文化未被更新，会继续使用旧文化解析数据。
3. 本地化资源管理器未正确通知UI更新：GlobalLocalizationResourceManager若未实现INotifyPropertyChanged，无法触发绑定控件刷新，导致显示内容未切换。

解决方案 #

1. 完善文化设置逻辑 #

确保覆盖所有线程的文化配置，同时显式设置MAUI应用依赖的文化上下文：

public static void SetAppLanguage(string appLanguagesCurrent)
{
    CultureInfo culture = new CultureInfo("en-US");
    if (appLanguagesCurrent == "English")
    {
        Commons.Language = "en";
    }
    else if (appLanguagesCurrent == "Română")
    {
        Commons.Language = "ro";
        culture = new CultureInfo("ro-RO");
    }

    // 当前线程文化
    Thread.CurrentThread.CurrentCulture = culture;
    Thread.CurrentThread.CurrentUICulture = culture;
    // 全局默认线程文化（影响新创建的线程）
    CultureInfo.DefaultThreadCurrentCulture = culture;
    CultureInfo.DefaultThreadCurrentUICulture = culture;
    // 应用级文化上下文
    CultureInfo.CurrentCulture = culture;
    CultureInfo.CurrentUICulture = culture;
}

2. 修复本地化资源管理器的通知机制 #

确保GlobalLocalizationResourceManager实现INotifyPropertyChanged，切换文化时触发所有绑定控件刷新：

public class GlobalLocalizationResourceManager : INotifyPropertyChanged
{
    private static readonly Lazy<GlobalLocalizationResourceManager> _instance = 
        new Lazy<GlobalLocalizationResourceManager>(() => new GlobalLocalizationResourceManager());
    public static GlobalLocalizationResourceManager Instance => _instance.Value;

    private readonly ResourceManager _resourceManager;
    private CultureInfo _currentCulture;

    public GlobalLocalizationResourceManager()
    {
        // 替换为你的实际RESX资源类
        _resourceManager = new ResourceManager(typeof(AppResources));
        _currentCulture = CultureInfo.CurrentUICulture;
    }

    public string this[string key] => _resourceManager.GetString(key, _currentCulture);

    public void SetCulture(CultureInfo culture)
    {
        _currentCulture = culture;
        // 触发所有绑定属性更新
        OnPropertyChanged(null);
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected virtual void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

3. 切换语言后刷新页面绑定 #

在登录页的SwitchLanguage函数中，添加当前页面绑定刷新逻辑，若使用Shell导航，可强制重新导航以确保新页面使用新文化：

private async Task SwitchLanguage(string language)
{
    CultureInfo switchToCulture;
    if (language == "EN")
    {
        Commons.Language = "en";
        Globals.AppSettings.Language = "English";
        switchToCulture = new("en-US");
    }
    else
    {
        Commons.Language = "ro";
        Globals.AppSettings.Language = "Română";
        switchToCulture = new("ro-RO");
    }

    MauiProgram.SetAppLanguage(Globals.AppSettings.Language);
    GlobalLocalizationResourceManager.Instance.SetCulture(switchToCulture);

    // 刷新当前页面绑定
    if (BindingContext is INotifyPropertyChanged vm)
    {
        vm.PropertyChanged?.Invoke(vm, new PropertyChangedEventArgs(null));
    }

    // 若使用Shell导航，强制重新导航到目标页面（示例为主页）
    await Shell.Current.GoToAsync("///MainPage", true);
}

4. 确保数据解析使用当前文化 #

修改数据解析代码，显式指定使用CultureInfo.CurrentCulture，避免硬编码或使用旧线程文化：

// 错误示例：硬编码文化
// var date = DateTime.Parse(dateString, new CultureInfo("en-US"));

// 正确示例：使用当前文化
var date = DateTime.Parse(dateString, CultureInfo.CurrentCulture);

内容的提问来源于stack exchange，提问作者Alex