ASP.NET Core Web Application (on .NET Framework) 프로젝트에서 외부 라이브러리 동적 로드 시 런타임 버전 문제
문제 재현을 위한 환경 구성을 해보면,
- ASP.NET Core Web Application (on .NET Framework)
- Class Library
위와 같이 2개의 프로젝트를 만든 후 웹 프로젝트에서 Class Library를 참조합니다. 더 이상의 변경 없이 다음의 코드를 웹 프로젝트에 넣어 실행해 값을 확인해 봅니다.
string txt = typeof(Controller).Assembly.FullName;
// txt == Microsoft.AspNetCore.Mvc.ViewFeatures, Version=2.0.1.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
제 컴퓨터 기준으로 보는 바와 같이 2.0.1.0 버전의 런타임 버전이 올라온 상태입니다.
자, 그렇다면 이 상태에서 Class Library에 "Microsoft.AspNetCore"를 NuGet을 통해서 2.0.0 버전으로 참조해 봅니다. 즉, 웹 사이트가 참조한 런타임은 2.0.1인데, 라이브러리만 2.0.0으로 참조하면 어떻게 동작하는가 하는 것입니다. Class Library측에서 다음의 코드를 마련하고,
public string GetText()
{
return typeof(HttpContext).Assembly.FullName;
}
ASP.NET Core 웹에서 GetText를 호출하면 결과는 다음과 같이 나옵니다.
Microsoft.AspNetCore.Http.Abstractions, Version=2.0.1.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
정리하면, ASP.NET Core는 프로젝트에서 직접 참조한 클래스 라이브러리를 로드할 때는 해당 DLL이 참조한 런타임 버전을 무시하고 현재 로드된 런타임을 적용합니다.
그렇다면, 동적으로 로드하면 어떻게 될까요? 아시다시피 .NET Full Framework은 Reflection에 자유롭기 때문에 다음과 같은 방식으로 로드하는 것이 가능합니다.
AssemblyName asmName = new AssemblyName();
asmName.Version = new Version(1, 0, 0, 0);
asmName.Name = "ClassLibrary1";
asmName.CultureInfo = CultureInfo.InvariantCulture;
asmName.SetPublicKeyToken(new byte[] { 0x92, 0x63, 0x73, 0xbd, 0x79, 0x91, 0x3f, 0x76 });
Assembly asm = Assembly.Load(asmName);
그런 다음, (2.0.0 런타임을 참조하는) 클래스 라이브러리의 GetText를 호출하면
Type type = asm.GetType("ClassLibrary1.Class1");
ConstructorInfo ctor = type.GetConstructor(new Type[] { });
object objClass = ctor.Invoke(null);
MethodInfo mi = type.GetMethod("GetText");
object result = mi.Invoke(objClass, new object[] { });
여지없이 다음과 같은 예외가 발생합니다.
Exception thrown: 'System.IO.FileLoadException' in mscorlib.dll
Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware: Error: An unhandled exception has occurred while executing the request
System.IO.FileLoadException: Could not load file or assembly 'Microsoft.AspNetCore.Http.Abstractions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)
File name: 'Microsoft.AspNetCore.Http.Abstractions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'
at System.Signature.GetSignature(Void* pCorSig, Int32 cCorSig, RuntimeFieldHandleInternal fieldHandle, IRuntimeMethodInfo methodHandle, RuntimeType declaringType)
at System.Reflection.RuntimeMethodInfo.InvokeArgumentsCheck(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
at System.Reflection.MethodBase.Invoke(Object obj, Object[] parameters)
at WebApplication1.Controllers.ValuesController.Get() in E:\WebApplication1\Controllers\ValuesController.cs:line 30
at lambda_method(Closure , Object , Object[] )
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.<InvokeActionMethodAsync>d__12.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.<InvokeNextActionFilterAsync>d__10.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.Rethrow(ActionExecutedContext context)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.Next(State& next, Scope& scope, Object& state, Boolean& isCompleted)
at Microsoft.AspNetCore.Mvc.Internal.ControllerActionInvoker.<InvokeInnerFilterAsync>d__14.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.AspNetCore.Mvc.Internal.ResourceInvoker.<InvokeNextResourceFilter>d__22.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at Microsoft.AspNetCore.Mvc.Internal.ResourceInvoker.Rethrow(ResourceExecutedContext context)
at Microsoft.AspNetCore.Mvc.Internal.ResourceInvoker.Next(State& next, Scope& scope, Object& state, Boolean& isCompleted)
at Microsoft.AspNetCore.Mvc.Internal.ResourceInvoker.<InvokeFilterPipelineAsync>d__17.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.AspNetCore.Mvc.Internal.ResourceInvoker.<InvokeAsync>d__15.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.AspNetCore.Builder.RouterMiddleware.<Invoke>d__4.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.<Invoke>d__7.MoveNext()
=== Pre-bind state information ===
LOG: DisplayName = Microsoft.AspNetCore.Http.Abstractions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
(Fully-specified)
LOG: Appbase = file:///E:/WebApplication1/bin/Debug/net47/
LOG: DEVPATH = C:\ProgramData\Red Gate\.NET Reflector\DevPath
LOG: Initial PrivatePath = NULL
Calling assembly : ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=926373bd79913f76.
===
LOG: This bind starts in default load context.
LOG: Using application configuration file: E:\WebApplication1\bin\Debug\net47\WebApplication1.exe.Config
LOG: Using host configuration file:
LOG: Using machine configuration file from C:\Windows\Microsoft.NET\Framework64\v4.0.30319\config\machine.config.
LOG: Post-policy reference: Microsoft.AspNetCore.Http.Abstractions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
LOG: Attempting download of new URL file:///E:/WebApplication1/bin/Debug/net47/Microsoft.AspNetCore.Http.Abstractions.DLL.
WRN: Comparing the assembly name resulted in the mismatch: Build Number
ERR: Failed to complete setup of assembly (hr = 0x80131040). Probing terminated.
'WebApplication1.exe' (CLR v4.0.30319: WebApplication1.exe): Loaded 'E:\WebApplication1\bin\Debug\net47\Microsoft.AspNetCore.WebUtilities.dll'. Cannot find or open the PDB file.
'WebApplication1.exe' (CLR v4.0.30319: WebApplication1.exe): Loaded 'E:\WebApplication1\WebApplication1\bin\Debug\net47\System.Reflection.Metadata.dll'. Symbols loaded.
즉, ASP.NET Core 런타임은 동적 로드한 DLL에 대해서는 런타임 보정을 안 해줍니다. 이에 대해 검색해 보면, AssembyLoadContext를 사용하면 된다고 하는데 아쉽게도 이것은 CoreCLR에서만 제공될 뿐 .NET Full Framework 하에서는 호출할 수 없습니다.
따라서 Assembly.Load로 사용할 DLL은 그것이 로드될 .NET Core 런타임에 맞춰 빌드해야 합니다. 그런데, 이게 말처럼 쉽지 않습니다. 사내 프로젝트 정도라면 그럴 수 있겠지만, 3rd-party 라이브러리 제작사 들이라면 2.0.0, 2.0.1, 2.0.2,... 와 같은 식으로 끝도 없이 나열될 버전에 따라 빌드를 맞춰줘야 한다는 게 됩니다. 어쨌든... 그다지 뾰족한 답이 없는 문제군요. ^^;
(
첨부한 프로젝트는 이 글의 예제 코드를 포함합니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]