.NET 8 이상만 지원하는 Microsoft.Data.SqlClient 6.1.0 버전
얼마전 nuget에 Microsoft.Data.SqlClient 6.1.0 버전이 릴리스됐습니다.
Microsoft.Data.SqlClient 6.1.0
; https://www.nuget.org/packages/microsoft.data.sqlclient
지원 범위에 .NET Standard 2.0이 있어,
.NET Standard
; https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0
원칙상 .NET Core 2.0 이상의 환경을 지원한다는 건데요, 그런데 실제로 해보면 .NET 8 미만의 환경에서는,
internal class Program
{
// .NET 7 이하의 프로젝트
// Install-Package Microsoft.Data.SqlClient
static void Main(string[] args)
{
SqlCommand cmd = new SqlCommand();
cmd.Parameters.AddWithValue("@param1", "value1");
}
}
SqlCommand 타입이 가진 대부분의 필드가 아래의 화면처럼,
Unhandled exception. System.NullReferenceException: Object reference not set to an instance of an object.
at Microsoft.Data.SqlClient.SqlCommand.get_Parameters()
at ConsoleApp1.Program.Main(String[] args)
null 참조 예외가 발생합니다. 디버깅 시 소스 코드로 들어가 보면 이런 식으로 구성이 되어 있는데,
...[생략]...
public bool EnableOptimizedParameterBinding { get { throw null; } set { } }
/// <include file='../../../../doc/snippets/Microsoft.Data.SqlClient/SqlCommand.xml' path='docs/members[@name="SqlCommand"]/Parameters/*'/>
public new Microsoft.Data.SqlClient.SqlParameterCollection Parameters { get { throw null; } }
/// <include file='../../../../doc/snippets/Microsoft.Data.SqlClient/SqlCommand.xml' path='docs/members[@name="SqlCommand"]/Transaction/*'/>
[System.ComponentModel.BrowsableAttribute(false)]
[System.ComponentModel.DesignerSerializationVisibilityAttribute(0)]
public new Microsoft.Data.SqlClient.SqlTransaction Transaction { get { throw null; } set { } }
...[생략]...
전형적인
참조 어셈블리의 내용입니다. 확인을 위해 디버깅 상태에서 모듈 창을 열어 DLL 경로를 알아내,
C:\temp\WebApplication1\WebApplication2\bin\Debug\net7.0\Microsoft.Data.SqlClient.dll
파일을 찾아가 보면 크기가 약 78KB인데요, nuget 패키지의 경로를 통해 다른 DLL과 비교하면,
[참조 어셈블리: 약 78KB]
"...nuget_root...\Microsoft.Data.SqlClient\extracted\6.1.0\ref\netstandard2.0\Microsoft.Data.SqlClient.dll"
[구현 어셈블리: 약 2MB]
"...nuget_root...\Microsoft.Data.SqlClient\extracted\6.0.2\runtimes\win\lib\net8.0\Microsoft.Data.SqlClient.dll"
확실히 참조 어셈블리가 맞습니다.
근본적인 원인은 패키지 오류인 듯합니다. 설치된 "microsoft.data.sqlclient.6.1.0.nupkg" 파일을 열어보면, ".\lib\netstandard2.0" 디렉터리에 참조 어셈블리가 들어 있습니다. 유사하게 ".\lib\net462"에는 구현 어셈블리가 들어 있는 것으로 봐서 아마도 패키지를 생성하는 담당자가 실수를 한 것이 아닌가... 싶습니다.
(2025-08-06 업데이트)
이슈를 넣었는데 원래 의도한 바라고 합니다. 즉, 6.1.0 버전부터는 적어도 .NET 7 이하로는 지원하지 않게 바뀌었습니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]