ASP.NET Core 지역화 문제 해결

  • 아티클

작성자: Hisham Bin Ateya

이 문서에서는 ASP.NET Core 앱 지역화 문제를 진단하는 방법에 대한 지침을 제공합니다.

지역화 구성 문제

지역화 미들웨어 순서
지역화 미들웨어가 예상대로 정렬되지 않으므로 앱이 지역화되지 않을 수 있습니다.

이 문제를 해결하려면 해당 지역화 미들웨어가 MVC 미들웨어 전에 등록되었는지 확인합니다. 그렇지 않으면 지역화 미들웨어는 적용되지 않습니다.

public void ConfigureServices(IServiceCollection services)
{
    services.AddLocalization(options => options.ResourcesPath = "Resources");

    services.AddMvc();
}

지역화 리소스 경로가 없음

RequestCultureProvider에서 지원되는 문화권이 등록된 문화권과 한 번 일치하지 않음

리소스 파일 이름 지정 문제

ASP.NET Core에는 지역화 리소스 파일 이름 지정에 대한 미리 정의된 규칙 및 지침이 있으며 ASP.NET Core의 세계화 및 지역화에 설명되어 있습니다.

누락된 리소스

리소스를 찾을 수 없는 일반적인 원인은 다음과 같습니다.

  • .NET XML 리소스 파일(.resx) 또는 지역화자 요청에서 리소스 이름의 철자가 잘못되었습니다.
  • 리소스가 일부 언어의 리소스 파일에서 누락되었지만 다른 언어에는 존재합니다.
  • 여전히 문제가 있는 경우 누락된 리소스에 대한 자세한 내용은 지역화 로그 메시지(로그 수준에 기록됨Debug)를 검사.

팁

사용하는 CookieRequestCultureProvider경우 작은따옴표가 지역화 cookie 값 내의 문화권과 함께 사용되지 않는지 확인합니다. 예를 들어 c='en-UK'|uic='en-US' 잘못된 cookie 값 c=en-UK|uic=en-US 이지만 유효합니다.

리소스 및 클래스 라이브러리 문제

ASP.NET Core는 기본적으로 클래스 라이브러리가 을 통해 ResourceLocationAttribute리소스 파일을 찾을 수 있도록 하는 방법을 제공합니다.

클래스 라이브러리와 관련된 일반적인 문제는 다음과 같습니다.

CustomRequestCultureProvider 가 예상대로 작동하지 않음

RequestLocalizationOptions 클래스에는 세 가지 기본 공급 기업이 포함됩니다.

이를 CustomRequestCultureProvider 통해 지역화 문화권이 제공되는 방식을 사용자 지정할 수 있습니다. 기본 공급 기업이 사용자 요구 사항을 충족하지 못할 때 CustomRequestCultureProvider를 사용합니다.

사용자 지정 공급자가 제대로 작동하지 않는 일반적인 이유는 목록의 첫 번째 공급자가 아니기 때문 RequestCultureProviders 입니다. 이 문제를 해결하려면:

  • 사용자 지정 공급자를 목록의 위치 0에 삽입합니다 RequestCultureProviders .

    options.AddInitialRequestCultureProvider(
    new CustomRequestCultureProvider(async context =>
    {
        // My custom request culture logic
        return new ProviderCultureResult("en");
    }));

  • 사용자 지정 공급자를 목록의 위치 0에 삽입합니다 RequestCultureProviders .

    options.RequestCultureProviders.Insert(0, 
    new CustomRequestCultureProvider(async context =>
    {
        // My custom request culture logic
        return new ProviderCultureResult("en");
    }));

루트 네임스페이스 문제

어셈블리의 루트 네임 스페이스가 어셈블리 이름과 다르면 지역화가 기본적으로 작동하지 않습니다. 이 문제를 방지하려면 ASP.NET Core의 세계화 및 지역화에 설명된 특성을 사용합니다RootNamespace.

Warning

프로젝트의 이름이 유효한 .NET 식별자가 아닌 경우 루트 네임스페이스 문제가 발생할 수 있습니다. 예를 들어 my-project-name.csproj 루트 네임스페이스와 my_project_name 어셈블리 이름을 my-project-name사용하여 이 오류가 발생합니다.

리소스 및 빌드 작업

지역화에 대해 리소스 파일을 사용하는 경우 적절한 빌드 작업이 포함되어야 합니다. 포함된 리소스를 사용합니다. 그렇지 않으면 ResourceStringLocalizer 이러한 리소스를 찾을 수 없습니다.

개발자 도구에서 "센서" 창을 사용하여 위치 재정의

Google Chrome 또는 Microsoft Edge 개발자 도구에서 센서 창을 사용하여 위치 재정의를 사용하는 경우 미리 렌더링한 후 대체 언어가 다시 설정됩니다. 테스트할 때 센서 창을 사용하여 언어를 설정하지 마세요. 브라우저의 언어 설정을 사용하여 언어를 설정합니다.

자세한 내용은 InteractiveServer(dotnet/aspnetcore#53707)에서 지역화가 작동하지 않음을 참조 Blazor 하세요.

유용한 문제 해결 팁과 관련된 GitHub 문제