기술 문서

Delphi vs FPC: PDFium 빌드의 숨겨진 코드 함정 4가지

동일한 오브젝트 파스칼(Object Pascal) 소스 코드이더라도 Delphi와 FPC/Lazarus 컴파일러 환경에 따라 다르게 작동하며 PDFium Component의 개발을 수차례 방해했던 대표적인 4가지 함정이 있습니다. 첫째, FPC는 in 집합 대조가 끝나기 전에 함수가 반환한 임시 레코드 변수를 조기 메모리 해제해 버립니다. 둘째, Delphi의 dcc32 컴파일러는 기본 범위 초과 검사를 끈 채로 빌드하므로 배열 범위 초과 인덱스 조회 시 에러 없이 가비지 데이터를 침묵 속에서 읽어 들입니다. 셋째, 오직 최신 Delphi 13 컴파일러만 명시적 캐스팅 없이 무명 array of Byte를 TBytes형에 대입하는 것을 허용합니다. 넷째, Delphi의 AnsiString 문자열 결합(concatenation)은 시스템 코드페이지 변환을 유발해 $80 이상의 물리 바이트 데이터를 16진수 문자 '?'($3F)로 왜곡시켜 파괴합니다. 이러한 차이점들로 인해 한쪽 컴파일러 빌드에서는 정상 합격(green)을 주지만, 다른 컴파일러 빌드에서는 예외 에러(red)를 내뱉거나 혹은 소리 소문 없이 망가진 결과물(silently wrong)을 생성하게 됩니다

두 컴파일러 프로젝트를 처음 세팅하는 거라면, Lazarus 및 FPC PDF 뷰어 구현 안내서가 정상 경로를 다룹니다. 패키지, 검색 경로, 화면에 렌더링 창 띄우기까지요. 이 글은 튜토리얼의 반대입니다. 정상 경로가 돌아간 뒤에 흔히 어긋나는 것들, 즉 한쪽 컴파일러는 통과하는 변경이 다른 쪽에서 터지는 상황을 다룹니다. 아래의 함정마다 최소 재현 코드와 원인, 그리고 우리가 표준으로 삼은 규칙이 따라옵니다

왜 FPC 빌드에서만 집합(set) 데이터가 조용히 빈 값으로 조회될까요?

한 줄 요약: FPC는 함수의 레코드 결과를 담은 임시 변수를, 그 결과의 필드를 읽는 식이 끝나기 전에 파이널라이즈할 수 있습니다. 그래서 X in Func().Issues는 이미 해제된 집합을 상대로 멤버십 검사를 할 수 있는 반면, 같은 Delphi 식은 잘 동작합니다. 테스트 어설션이 전형적인 발생 지점입니다. PDF/E 검증기가 위반 플래그 집합인 Issues 필드를 지닌 레코드를 반환하고, 호출을 어설션 안에 인라인하는 게 자연스럽기 때문입니다

Delphi는 PDFium 함수 결과 레코드를 문장이 끝날 때까지 임시로 살려두는 반면, FPC는 in 연산자가 Issues 집합을 읽기 전에 해제해, 어설션은 Delphi에서만 통과됨을 보여주는 다이어그램
Delphi는 함수 결과 레코드 임시 객체를 문이 끝날 때까지 살려 두는 반면, FPC는 in 연산자가 Issues 집합을 읽기 전에 해제할 수 있습니다
// FPC에서는 신뢰할 수 없음: 함수 결과 레코드 임시값은
// 'in' 테스트가 Issues를 읽기 전에 해제될 수 있음
AssertTrue(pveiLzwUsed in ValidateAnsi(Pdf).Issues);

// 두 컴파일러 모두에서 신뢰할 수 있음: 결과를 먼저 로컬에 고정
var
  Vr: TPdfEValidationResult;
begin
  Vr := ValidateAnsi(Pdf);
  AssertTrue(pveiLzwUsed in Vr.Issues);
end;

인라인 형태는 FPC 아래에서 집합을 빈 것으로 읽었으므로 플래그를 기대한 어설션은 전부 실패했고, 동일한 Delphi 빌드는 통과했습니다. 근본 원인은 두 컴파일러가 더 큰 식 안에서 함수 결과 임시값의 수명을 관리하는 방식의 차이입니다. Delphi는 임시값을 문장 끝까지 살려 두는 반면, FPC의 레코드 임시값 해제는 아직 읽고 있는 집합 멤버십 연산자와 경쟁할 수 있습니다. 망가진 형태는 한 번 문서화한 뒤에도 다시 스멀스멀 들어올 만큼 자연스러워 보입니다. 해결은 기계적이고 전면 규칙으로 채택할 가치가 있습니다. 레코드를 반환하는 함수 호출에 필드 접근이나 집합 검사를 곧바로 체인하지 마세요. 결과를 로컬 변수에 먼저 대입한 다음 필드를 읽으세요. 한 줄 비용으로 컴파일러 의존적 깨진 부류 전체를 없앱니다

왜 Delphi에서는 통과된 배열 인덱스가 FPC에서는 컴파일 에러를 일으킬까요?

한 줄 요약: dcc32는 고정 범위 배열에 대한 범위 밖 인덱스를 컴파일하고, 기본 범위 검사가 꺼져 있으므로 런타임에 아무 오류 없이 인접 메모리를 읽거나 씁니다. 반면 FPC는 같은 인덱스를 컴파일 시점에 거부합니다. PDFium Component는 quad points를 1 기반 배열 TQuadrilateralPoint = array [1..4] of TPdfPoint로 선언하는데, 이는 PDF의 QuadPoints 엔트리가 보통 번호 매겨지는 방식과 맞습니다. 반사적으로 0 기반 인덱스로 채우는 데모 루프는 Delphi 아래에서 돌아가는 것처럼 보입니다

PDFium Component 다이어그램: 1 기반 PDF quad-points 배열에서 dcc32 아래 인덱스 0은 인접 레코드 필드를 조용히 건드리는 반면, FPC는 같은 루프를 컴파일 타임 범위 검사 오류로 멈춤
dcc32 범위 검사가 꺼져 있으면 인덱스 0이 조용히 이웃 레코드 필드에 떨어지는 반면, FPC는 같은 루프를 컴파일 시점에 거부합니다
var
  I: Integer;
begin
  for I := 0 to 3 do                       // 틀림: 배열은 [1..4]
    Data.AttachmentPoints[I] := Corner[I]; // dcc32 기본값: 컴파일됨, 인덱스 0
                                           // 인접 메모리를 조용히 건드림
                                           // FPC: 컴파일 시 범위 검사 오류
  for I := Low(TQuadrilateralPoint) to High(TQuadrilateralPoint) do
    Data.AttachmentPoints[I] := Corner[I - 1];  // 두 컴파일러 모두에서 올바름
end;

Delphi 빌드는 위양성입니다. 범위 검사가 꺼진 dcc32 기본값에서는 인덱스 0이 레코드에서 배열 앞에 있는 무슨 필드든 위에 착지하고, 데모는 돌아가는 것처럼 보입니다. 같은 코드를 Lazarus 아래에서 빌드하면 FPC가 즉시 컴파일 시점 범위 검사 오류를 냅니다. quad points의 어노테이션 쪽은 quad-points 어노테이션 글에서 다룹니다. 여기서 두 가지 교훈이 나옵니다. 첫째, 배열 타입이 구조적으로 0 기반이 아닌 이상 리터럴 경계보다 Low()와 High()를 선호하세요. 둘째, 새 데모나 테스트의 첫 실행 게이트로 FPC 컴파일, 최소한 {$R+}를 켠 Delphi 빌드 한 번을 의무화하세요. dcc32 기본값은 이 부류의 버그를 알려 주지 않고, 돌아가는 프로그램이 올바른 증거는 아니니까요

오직 최신 Delphi 13만 허용하는 TBytes 대입 규칙의 함정

한 줄 요약: 무명으로 지정된 array of Byte 배열 필드를 일반 TBytes 변수에 직접 대입하는 것은 최신 Delphi 13(컴파일러 버전 37.0)에서는 정상 컴파일되지만, Delphi 12 Athens 이하의 하위 버전에서는 E2010 Incompatible types: 'TArray<Byte>' and 'Dynamic array' 타입 컴파일 에러를 일으키며 실패합니다. 이는 Delphi와 FPC 컴파일러 간의 호환성이라기보다 Delphi 신구 컴파일러 버전 간의 차이지만 크로스 컴파일 프로젝트에 똑같이 치명적인 결함을 유발합니다. 가장 최신 컴파일러가 하위 버전에서는 기각되는 잘못된 형변환 구문을 조용히 수락하기 때문입니다

type
  TValidator = class
  private
    FBuffer: array of Byte;   // 무명 동적 배열 타입
  end;

var
  OrigBytes: TBytes;
begin
  OrigBytes := FBuffer;          // Delphi 13 전용; Delphi 12에서는 E2010
                                 // Athens 및 이하 버전
  OrigBytes := TBytes(FBuffer);  // 어디서나 컴파일됨; 동일한 바이트 배치,
                                 // 안전한 하드 형변환
end;

Delphi 13에서 개발하면 이 함정에 빠지기 쉽습니다. 암시적 변환이 조용히 수락되는 환경이니까요. 같은 소스를 Delphi 12 이하로 컴파일하는 사용자는 대신 E2010을 맞습니다. 구조적 해결은 위에 보인 하드 캐스트인데, 무명 array of Byte와 TBytes가 동일한 동적 배열 레이아웃을 공유하므로 안전합니다. 더 나은 방법은 애초에 필드를 TBytes 같은 이름 붙은 타입으로 선언해 변환이 생길 여지를 없애는 것입니다. 절차적 해결이 더 중요합니다. 최신 툴체인에서 컴파일되는 구문은 사용자가 실제로 돌리는 오래된 컴파일러에 대해 아무것도 증명하지 못하고, 이 부류의 문제는 지원하는 모든 버전으로 빌드해 보기 전까지는 보이지 않습니다. 로컬 37.0 빌드는 13 전용 관대함을 잡지 못하니까요

중국어 로케일 Windows 환경에서 조용히 증발하는 AnsiString 특수 바이트

한 줄 요약: $80 이상의 날 바이트를 +로 AnsiString에 이어 붙이면 Delphi 아래에서 그 바이트가 조용히 ?($3F)로 바뀔 수 있습니다. 식이 시스템 코드 페이지를 통과하는 암시적 AnsiString → UnicodeString → AnsiString 왕복을 타기 때문입니다. 전형적인 발생 장소는 PDF/A 테스트입니다. 고립된 $FE 바이트, 절대 합법적인 UTF-8 선두 바이트가 아닌 값을 담은 이름을 만들어, ISO 19005-2 6.1.8절의 유효하지 않은 UTF-8 이름에 검증기가 플래그를 세우는지 확인하죠

CP936 중국어 Windows 머신에서 원시 $FE 바이트를 물음표로 바꾸는 AnsiString 대 UnicodeString 왕복 다이어그램과, Delphi의 안전한 제자리 바이트 패치 병기
암묵적 UnicodeString 왕복은 CP936 아래에서 사상 불가능한 $FE 바이트를 $3F로 바꾸므로, 안전한 경로는 그 바이트를 제자리에서 고칩니다
var
  BadName: AnsiString;
begin
  // 멀티바이트 시스템 코드 페이지(CP936에서 관찰됨)의 Delphi에서
  // 결합은 UnicodeString을 통해 왕복하며 $FE는 유효한 CP936 시퀀스가
  // 아니므로 '?'($3F)로 되돌아옵니다
  BadName := '/Bad' + AnsiChar($FE) + 'Name';

  // 안전: ASCII 자리 표시자로 만든 다음 바이트를 그 자리에 패치합니다;
  // 고정된 AnsiString에 대한 인덱스 대입은 왕복하지 않음
  BadName := '/Bad' + #1 + 'Name';
  BadName[5] := AnsiChar($FE);
end;

코드 페이지 936을 돌리는 중국어 Windows 시스템에서는 결합된 문자열이 애초에 $FE를 담고 있지 않았습니다. 검증기는 아무것도 보고하지 않는 것이 옳았고, 테스트는 검증기와 아무 상관없는 이유로 빨개졌습니다. 실제로 $FE 바이트를 담은 PDF를 주면 기대한 플래그를 보고합니다. 파손은 문자열 식이 평가되는 동안 Delphi 테스트 실행 파일 안에서 일어났습니다. Delphi의 유니코드 우선 문자열 모델은 뒤섞인 AnsiString 식을 UnicodeString으로 변환하는데, $FE는 CP936에서 유효한 선두 바이트가 아니라서 왕복이 그것을 대체해 버립니다. 경계에 대해 솔직해지면, CP1252 같은 1바이트 서구 코드 페이지에서는 같은 식이 보통 살아남습니다. 그래서 이 문제는 대부분의 개발 머신에서 숨고, 동아시아 시스템이나 현지화된 CI 러너에서만 표면화합니다. 우리가 채택한 규칙: $80 이상의 바이트를 담은 바이너리 테스트 벡터는 AnsiString 연결로 만들지 마세요. 문자열이 고정된 뒤 위처럼 바이트를 제자리에 패치하거나, 처음부터 TBytes로 벡터를 구성하세요

듀얼 컴파일 크로스 개발 환경에서 지켜야 할 체크리스트

네 함정, 하나의 패턴: 각 컴파일러는 여러분 버그의 서로 다른 부분집합을 알려 줍니다. FPC의 컴파일 시점 범위 분석은 dcc32가 조용히 실행하는 범위 밖 인덱스를 잡고, dcc32의 유니코드 문자열 모델은 순수 바이트 지향 FPC 빌드가 결코 유발하지 않는 코드 페이지 의존성을 드러냅니다. 실천적 결론은 어느 한쪽의 초록 파이프라인으로는 충분하지 않다는 것입니다. 크로스 컴파일은 이식성 체크박스 그 이상입니다. 같은 소스에 적용하는 두 번째 정적 분석기이자 두 번째 런타임 모델이며, ABI 및 메모리 안전성 강화 글의 방어적 경계 검사와 같은 정신입니다

이 함정들에서 나오는 상시 규칙은 외울 수 있을 만큼 짧습니다. 함수 결과 레코드는 필드를 읽기 전에 로컬 변수에 고정하세요. 고정 범위 배열은 Low()와 High()로 순회하고, 새 데모를 신뢰하기 전에 최소 한 번은 범위 검사를 켠 빌드나 FPC 빌드를 돌리세요. 무명 동적 배열 필드는 명시적으로 캐스트하거나 이름 붙은 타입으로 선언하고, 릴리스 전에 컴파일러 매트릭스 전체를 빌드하세요. 날 하이 바이트는 AnsiString 연결에 아예 넣지 마세요. 습관이 되면 어느 하나도 측정 가능한 공수를 요구하지 않고, 각각은 단일 컴파일러 워크플로가 구조적으로 볼 수 없는 실패 모드를 하나씩 닫습니다

이 규칙들은 Delphi, C++Builder, FPC/Lazarus에 같은 Object Pascal 소스를 공급하는 PDFium Component를 유지 관리하면서 나온 것입니다