C# 리플렉션과 애트리뷰트: Invoke 비용 실측과 AOT 경고

Type·MethodInfo로 멤버 조회, 커스텀 애트리뷰트 정의와 읽기, Invoke와 직접 호출·델리게이트 속도 실측, Native AOT에서 나는 IL2026·IL2057 경고와 소스 생성기 대안까지.

2026년 11월 보강: 2021년에 쓴 리플렉션·애트리뷰트 강좌의 예제를 .NET 10.0.14(C# 14)에서 다시 컴파일하고 실행했습니다. 2021년 글의 경고·오류 목록은 Visual Studio 2012 출력을 그대로 붙인 것이라 개인 PC의 사용자 폴더 경로가 들어 있었고 오류 코드가 없었습니다. 모두 지우고 dotnet build의 실제 출력(CS0618, CS0619, CS0592)으로 바꿨습니다. 또 "Conditional은 메서드를 컴파일할지 결정한다", "위치 매개변수는 따옴표로 쓴다" 같은 틀린 설명을 바로잡고, Invoke 비용 실측과 Native AOT·트리밍 경고를 더했습니다.

이 글은 C#에서 리플렉션으로 형식 정보를 읽거나 메서드를 동적으로 호출해야 하는 분, 그리고 직접 만든 애트리뷰트를 실행 중에 읽어 검증·매핑 같은 기능을 만들려는 분을 위한 글입니다. 결론부터 말하면 리플렉션은 강력하지만 비싸고, 2026년에는 AOT와도 충돌합니다. 반복 호출이라면 델리게이트로 한 번 바꿔 두고, 새로 만드는 코드라면 소스 생성기로 같은 일을 컴파일 시점에 끝낼 수 있는지 먼저 따져 보세요.

리플렉션 기본: Type에서 멤버 목록 꺼내기

리플렉션은 실행 중에 형식의 메타데이터(생성자, 메서드, 필드, 속성, 애트리뷰트)를 조사하고, 그 정보로 인스턴스를 만들거나 메서드를 호출하는 기능입니다. 출발점은 언제나 System.Type입니다.

메서드 반환 형식 설명
obj.GetType() / typeof(T) Type 인스턴스 또는 형식의 Type 개체
GetConstructors() ConstructorInfo[] public 생성자 목록
GetMethods() MethodInfo[] public 메서드 목록(상속 포함)
GetFields() FieldInfo[] public 필드 목록
GetProperties() PropertyInfo[] public 속성 목록
GetMembers() MemberInfo[] 위 전부

2021년 예제(Animal 클래스에 필드 2개, 생성자, 메서드 2개)를 그대로 실행한 결과입니다.

Animal animal = new Animal("고양이", 4);
Type type = animal.GetType();
foreach (ConstructorInfo c in type.GetConstructors()) Console.WriteLine("\t{0}", c);
foreach (MethodInfo m in type.GetMethods()) Console.Write("\t{0}", m);
foreach (FieldInfo f in type.GetFields()) Console.Write("\t{0}", f);
생성자(Constructor) :  Void .ctor(System.String, Int32)

메소드(Method) :   Void eat()  Void sleep()    System.Type GetType()   System.String ToString()    Boolean Equals(System.Object)   Int32 GetHashCode()
필드(Field) :     Int32 age   System.String name

2021년 출력과 비교하면 GetType()과 ToString()의 순서가 바뀌었습니다. GetMethods는 반환 순서를 보장하지 않으므로(Microsoft Learn의 Type.GetMethods 설명), 순서에 의존하는 코드를 쓰면 안 됩니다. 이름으로 찾을 때는 GetMethod("eat"), 비공개 멤버까지 보려면 BindingFlags.NonPublic | BindingFlags.Instance를 넘깁니다.

기본 제공 애트리뷰트: Conditional, Obsolete, DllImport

애트리뷰트는 [이름(위치 인수, 이름 = 값)] 형태로 코드 요소에 붙이는 메타데이터입니다. 2021년 글은 위치 매개변수를 "따옴표로 쓴다"고 설명했지만, 문자열만 되는 것이 아닙니다. 위치·명명 인수 모두 컴파일 시간 상수여야 하고, 허용되는 형식은 bool, char, 정수·실수 기본 형식, string, Type, enum, object, 그리고 이들의 1차원 배열입니다. decimal은 상수처럼 보여도 안 됩니다.

Program.cs(17,2): error CS0181: 특성 생성자 매개 변수 'value'이(가) 유효한 특성 매개 변수 형식이 아닌 'decimal' 형식을 사용하고 있습니다.

Conditional. 2021년 글은 "메서드를 컴파일할지 말지 결정한다"고 했는데, 정확히는 호출을 지웁니다. 메서드 자체는 항상 컴파일됩니다. #define TEST가 있을 때와 없을 때를 실행해 확인했습니다.

#define TEST            // ← 이 줄을 지우고 다시 실행
using System.Diagnostics;

class Program
{
    [Conditional("TEST")]
    public void TestConditional() => Console.WriteLine("TestConditional!");

    static void Main()
    {
        new Program().TestConditional();
        var mi = typeof(Program).GetMethod(nameof(TestConditional));
        Console.WriteLine($"method still in assembly: {mi is not null}");
    }
}
TestConditional!
method still in assembly: True
(#define TEST 를 지운 빌드)
method still in assembly: True

Debug.WriteLine이 Release 빌드에서 사라지는 것도 같은 원리([Conditional("DEBUG")])입니다. 호출이 지워지면 인수 식도 평가되지 않으므로, 인수에 부수 효과가 있는 코드를 넣지 않도록 주의하세요.

Obsolete. 2021년 글의 경고·오류 목록은 개인 경로가 들어간 Visual Studio 2012 화면 출력이었습니다. .NET 10 SDK에서 다시 빌드한 출력입니다. ObsoleteAttribute의 DiagnosticId와 UrlFormat 속성도 함께 넣었습니다.

[Obsolete("Use NewMethod() instead.")]
public void OldMethod() { Console.WriteLine("OLD!"); }

[Obsolete("Removed. Use NewMethod().", true)]
public void OlderMethod() { }

[Obsolete("Use NewMethod2.", DiagnosticId = "TLAB001", UrlFormat = "https://example.com/{0}")]
public void OldMethod2() { }
Program.cs(17,9): warning CS0618: 'Program.OldMethod()'은(는) 사용되지 않습니다. 'Use NewMethod() instead.'
Program.cs(19,9): error CS0619: 'Program.OlderMethod()'은(는) 사용되지 않습니다. 'Removed. Use NewMethod().'
Program.cs(20,9): warning TLAB001: 'Program.OldMethod2()'은(는) 사용되지 않습니다. 'Use NewMethod2.' (https://example.com/TLAB001)

두 번째 인수 true면 경고(CS0618)가 오류(CS0619)로 바뀝니다. DiagnosticId를 주면 경고 코드가 CS0618 대신 그 ID가 되어, 라이브러리 사용자가 <NoWarn>TLAB001</NoWarn>처럼 그 경고만 골라 끌 수 있습니다.

DllImport. 2021년 예제(User32.dll의 MessageBox)는 net10.0으로 macOS에서도 경고 없이 컴파일됩니다. 네이티브 DLL은 컴파일 시점이 아니라 처음 호출할 때 찾기 때문입니다. 이 Mac에서 실행하면 첫 호출에서 실패합니다(출력 일부).

OS: macOS 26.6.2
Unhandled exception. System.DllNotFoundException: Unable to load shared library 'User32.dll' or one of its dependencies. …

Windows에서의 동작(메시지 상자 표시)은 여기서 실행하지 못했으므로 Microsoft Learn의 설명에 맡깁니다. 2021년 시그니처의 int hParent는 원래 포인터 크기 핸들(HWND)이라 nint가 맞습니다. .NET 7 이후에는 소스 생성기 기반 LibraryImport가 권장됩니다. 아래 코드는 net10.0에서 컴파일만 확인했고, macOS에서는 분기로 건너뜁니다.

static partial class Native
{
    [LibraryImport("user32.dll", StringMarshalling = StringMarshalling.Utf16)]
    internal static partial int MessageBoxW(nint hWnd, string text, string caption, uint type);
}

처음에는 csproj에 <AllowUnsafeBlocks>true</AllowUnsafeBlocks>가 없어서 실패했습니다. 생성된 코드가 unsafe이기 때문입니다.

CSC : error SYSLIB1062: LibraryImportAttribute에는 안전하지 않은 코드가 필요합니다. 프로젝트는 '<AllowUnsafeBlocks>true</AllowUnsafeBlocks>'로 업데이트해야 합니다.

커스텀 애트리뷰트 만들고 실행 중에 읽기

System.Attribute를 상속하면 애트리뷰트를 직접 만들 수 있습니다. 2021년 예제에 [AttributeUsage(AttributeTargets.Method)]를 붙이고 클래스에 쓰면 이렇게 실패합니다(개인 경로가 들어 있던 2021년 출력을 대체).

Program.cs(1,2): error CS0592: 이 선언 형식에서는 'CustomAttribute' 특성이 유효하지 않습니다. 이 특성은 '메서드' 선언에서만 유효합니다.

AttributeTargets.Method | AttributeTargets.Class처럼 비트 OR로 묶으면 통과합니다. .NET 10의 AttributeTargets 값은 실행해서 꺼내 보면 다음 16개입니다. 2021년 표에 없던 GenericParameter가 있습니다.

Assembly, Module, Class, Struct, Enum, Constructor, Method, Property, Field, Event, Interface, Parameter, Delegate, ReturnValue, GenericParameter, All

2021년 예제는 애트리뷰트를 붙이기만 하고 읽지 않았습니다. 애트리뷰트는 누가 리플렉션으로 읽어야 비로소 의미가 생깁니다. 아래는 속성에 붙인 규칙을 읽어 값을 검사하는 작은 검증기입니다.

using System.Reflection;

[AttributeUsage(AttributeTargets.Property)]
sealed class NotEmptyAttribute : Attribute;

[AttributeUsage(AttributeTargets.Property)]
sealed class RangeAttribute(int min, int max) : Attribute
{
    public int Min { get; } = min;
    public int Max { get; } = max;
    public string? Message { get; init; }   // 명명 인수
}

sealed class SignupForm
{
    [NotEmpty] public string Email { get; set; } = "";
    [Range(14, 120, Message = "age must be 14-120")] public int Age { get; set; }
}

static class Validator
{
    public static IEnumerable<string> Validate(object obj)
    {
        foreach (PropertyInfo p in obj.GetType().GetProperties())
        {
            object? value = p.GetValue(obj);
            if (p.IsDefined(typeof(NotEmptyAttribute)) && string.IsNullOrEmpty(value as string))
                yield return $"{p.Name}: must not be empty";
            if (p.GetCustomAttribute<RangeAttribute>() is { } r && value is int n && (n < r.Min || n > r.Max))
                yield return $"{p.Name}: {r.Message ?? $"{r.Min}..{r.Max}"} (was {n})";
        }
    }
}

new SignupForm { Email = "", Age = 12 }를 넣은 결과입니다.

Email: must not be empty
Age: age must be 14-120 (was 12)

AllowMultiple(기본 false)과 Inherited(기본 true)도 확인했습니다. AllowMultiple = false인 애트리뷰트를 두 번 붙이면 error CS0579('Tag' 특성이 중복되었습니다.)가 납니다. 부모 클래스에 [Tag("base1"), Tag("base2")](AllowMultiple, Inherited = true)와 [SealedMark](Inherited = false)를 붙이고 자식 클래스에서 읽은 결과입니다.

Tags on Child (inherit:true): base1,base2
Tags on Child (inherit:false):
IsDefined(Child, Sealed, inherit:true): False

inherit: true로 물어야 부모의 애트리뷰트가 보이고, Inherited = false인 애트리뷰트는 그래도 보이지 않습니다. 2021년 글의 "커스텀 애트리뷰트는 컴파일에 영향을 주지 못한다"는 설명도 이제는 반만 맞습니다. 분석기와 소스 생성기는 컴파일 시점에 커스텀 애트리뷰트를 읽어 경고를 내거나 코드를 만듭니다. 위의 LibraryImport와 아래의 [JsonSerializable]이 그 예입니다.

Invoke는 얼마나 느린가: 직접 호출·델리게이트와 실측

int Add(int a, int b)(인라인 금지)를 1,000만 번 호출했습니다. .NET 10.0.14, Release 빌드, Apple M1 Pro, 5회 측정의 중앙값이고, 할당은 GC.GetAllocatedBytesForCurrentThread() 차이를 호출 수로 나눈 값입니다. 마지막 줄은 매번 GetMethod로 찾는 경우라 100만 번만 돌렸습니다.

MethodInfo mi = typeof(Calc).GetMethod(nameof(Calc.Add))!;
var invoker = MethodInvoker.Create(mi);                          // .NET 8+
var del = mi.CreateDelegate<Func<Calc, int, int, int>>();        // 열린 인스턴스 델리게이트

s += calc.Add(i, 1);                          // 직접 호출
s += del(calc, i, 1);                         // CreateDelegate
s += (int)invoker.Invoke(calc, i, 1)!;        // MethodInvoker
s += (int)mi.Invoke(calc, [i, 1])!;           // MethodInfo.Invoke
방식 호출당 시간(중앙값) 최소~최대 호출당 할당
직접 호출 1.13ns 1.09~1.15 0B
CreateDelegate 델리게이트 1.60ns 1.56~1.70 0B
MethodInvoker.Invoke 17.00ns 16.37~25.06 72B
MethodInfo.Invoke 32.73ns 32.01~33.82 112B
매번 GetMethod + Invoke 43.72ns 39.66~69.31 112B
호출당 나노초 막대그래프: 직접 호출 1.13, CreateDelegate 델리게이트 1.60, MethodInvoker 17.00, MethodInfo.Invoke 32.73, 매번 GetMethod 와 Invoke 43.72. 캐시한 델리게이트는 직접 호출과 거의 같고 MethodInfo.Invoke 는 약 29배 느리다.
int Add(int, int) 호출 1회당 시간, 1,000만 회(마지막 막대는 100만 회)를 5번 잰 중앙값. .NET 10.0.14, Release 빌드, Apple Silicon Mac(M1 Pro). Invoke는 호출당 112바이트, MethodInvoker는 72바이트를 할당했고 나머지는 0.

MethodInfo.Invoke는 직접 호출의 약 29배였고, 인수 배열과 int 박싱 때문에 호출마다 112바이트를 할당했습니다. MethodInvoker(net7.0으로 빌드하면 error CS0103, net8.0에서 통과)는 배열 없이 인수를 넘겨 절반 정도로 줄었습니다. 가장 효과가 큰 것은 CreateDelegate로, 한 번 만들어 두면 직접 호출과 0.5ns 차이였습니다. 32ns가 작아 보여도 요청 하나에 수천 번 부르는 직렬화·매핑 코드라면 차이가 쌓입니다. 플러그인 로딩처럼 한 번 찾고 오래 쓰는 경우에는 Invoke로 충분합니다.

2026년의 주의점: 트리밍·Native AOT 경고와 소스 생성기

.NET 8 이후 Native AOT와 트리밍이 실무에 들어오면서 리플렉션은 새 문제를 만났습니다. 트리머는 코드에서 정적으로 보이는 형식과 멤버만 남기고 나머지를 지웁니다. 문자열로만 이름을 아는 형식은 지워질 수 있습니다. csproj에 <IsAotCompatible>true</IsAotCompatible>를 넣으면 일반 빌드에서도 AOT 분석기가 켜져 이런 코드에 경고를 냅니다.

string name = args.Length > 0 ? args[0] : Console.ReadLine() ?? "";
Type? t = Type.GetType(name);
Console.WriteLine(JsonSerializer.Serialize(new Point(1, 2)));
Program.cs(5,11): warning IL2057: Unrecognized value passed to the parameter 'typeName' of method 'System.Type.GetType(String)'. It's not possible to guarantee the availability of the target type.
Program.cs(10,19): warning IL2026: Using member 'System.Text.Json.JsonSerializer.Serialize<TValue>(TValue, JsonSerializerOptions)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. …
Program.cs(10,19): warning IL3050: Using member 'System.Text.Json.JsonSerializer.Serialize<TValue>(TValue, JsonSerializerOptions)' which has 'RequiresDynamicCodeAttribute' can break functionality when AOT compiling. …

IL 경고는 DOTNET_CLI_UI_LANGUAGE=ko로 빌드해도 영어로만 나왔습니다. 경고를 무시하고 dotnet publish -p:PublishAot=true로 실제 네이티브 실행 파일(약 2.1MB)을 만들어 돌려 보았습니다.

  • 문자열로만 이름이 나오는 LegacyPlugin 클래스: JIT 실행(dotnet run -- LegacyPlugin)에서는 Type.GetType 결과가 LegacyPlugin, AOT 실행 파일에서는 null이었습니다.
  • 리플렉션 기반 JsonSerializer.Serialize: AOT 실행 파일에서 InvalidOperationException: Reflection-based serialization has been disabled for this application.로 종료했습니다.

해결은 "트리머가 볼 수 있게 하기"입니다. 형식을 typeof로 고정하고 필요한 멤버 종류를 [DynamicallyAccessedMembers]로 알리거나, 리플렉션 자체를 소스 생성기로 바꿉니다.

static string? CallHello(
    [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicMethods |
                                DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)] Type type)
    => type.GetMethod("Hello")?.Invoke(Activator.CreateInstance(type), null) as string;

Console.WriteLine(CallHello(typeof(Plugin)));                                         // 경고 없음
Console.WriteLine(JsonSerializer.Serialize(new Point(1, 2), AppJson.Default.Point)); // 경고 없음

[JsonSerializable(typeof(Point))] partial class AppJson : JsonSerializerContext;

이 두 줄은 IL 경고 없이 빌드됐고, AOT 실행 파일에서도 hello from Plugin과 {"X":1,"Y":2}를 출력했습니다. 남은 경고는 문자열로 형식을 찾는 IL2057 하나뿐이었습니다. 이것은 설계상 피할 수 없으므로, 플러그인처럼 정말 이름으로 찾아야 한다면 AOT를 포기하거나 후보 형식을 미리 등록해 두는 쪽을 택해야 합니다.

멤버를 호출하거나 조사해야 할 때의 판단 도식. 질문 1: 형식을 컴파일 시점에 아는가? 예면 제네릭이나 인터페이스. 아니오면 질문 2: 트리밍이나 Native AOT로 게시하는가? 예면 소스 생성기, 또는 typeof와 DynamicallyAccessedMembers. 아니오면 질문 3: 여러 번 반복 호출하는가? 예면 CreateDelegate로 델리게이트를 캐시. 아니오면 MethodInfo.Invoke로 충분.
2026년에 리플렉션과 대안을 고르는 흐름. 아래로 갈수록 실행 시간 비용이나 트리밍·AOT 경고가 줄어든다.

정리하면, 리플렉션은 "실행 중에만 알 수 있는 것"을 다루는 마지막 수단입니다. 형식을 컴파일 시점에 알 수 있다면 제네릭이나 인터페이스로, 반복 호출이라면 델리게이트 캐시로, AOT 대상이라면 소스 생성기로 바꾸는 것이 2026년의 기본값입니다. 델리게이트 자체가 처음이라면 Func와 Action 델리게이트, 제네릭 제약은 C# 제네릭을 참고하세요.

검증 환경: .NET SDK 10.0.403 / 런타임 10.0.14, C# 14, macOS(Apple M1 Pro). Native AOT는 osx-arm64로 게시. Windows 전용 DllImport·LibraryImport 호출은 컴파일만 확인하고 Windows에서는 실행하지 않음.

자주 묻는 질문

리플렉션 Invoke는 직접 호출보다 얼마나 느린가요?

MethodInfo.Invoke는 호출당 약 32.7ns와 112바이트 할당으로, 직접 호출(1.13ns)의 약 29배였습니다. .NET 8의 MethodInvoker는 17.0ns, CreateDelegate로 만든 델리게이트는 1.60ns로 직접 호출에 가까웠습니다(.NET 10, Release, Apple M1 Pro, 1,000만 회). 같은 메서드를 반복 호출한다면 델리게이트로 한 번 바꿔 두세요.

Conditional 애트리뷰트를 붙인 메서드는 컴파일에서 빠지나요?

아닙니다. 메서드 자체는 항상 컴파일되어 어셈블리에 남고, 기호가 정의되지 않았을 때 빠지는 것은 호출하는 코드입니다. #define TEST를 지운 빌드에서도 typeof(Program).GetMethod("TestConditional")은 null이 아니었습니다.

Native AOT에서 리플렉션을 쓰면 어떻게 되나요?

빌드 때 IL2057, IL2026, IL3050 같은 경고가 나고, 실행하면 트리머가 지운 형식은 찾지 못합니다. 문자열로만 참조한 클래스를 Type.GetType으로 찾으면 JIT 실행에서는 찾았지만 AOT 실행 파일에서는 null이었습니다. 형식을 코드로 고정하고 DynamicallyAccessedMembers를 붙이거나 소스 생성기로 바꾸면 경고가 사라집니다.

  • #C#
  • #리플렉션
  • #애트리뷰트
  • #Native AOT
  • #.NET 10

t.laboratory

직접 만들고 운영하는 앱·서버·서비스에서 겪은 문제와, 그 해결에 쓴 코드를 기록하는 기술 블로그입니다.

운영자 소개 · 앱

↑