이 글의 목적은 엑셀에서 Add-in(애드인)이 충돌을 일으킬 때 문제를 빠르게 진단하고 안전하게 해결하는 실무 절차와 체크리스트를 제공하는 것이다.
1. 충돌 증상 빠른 판별 체크리스트
충돌 증상을 유형별로 구분하면 원인 추적 속도가 빨라진다. 아래 표를 먼저 확인하여 현재 증상에 맞는 진단 루트를 선택한다.
| 주요 증상 | 가능 원인 | 우선 조치 |
|---|---|---|
| 엑셀 시작 지연·멈춤 | COM 추가 기능의 초기화 지연, 서명 검증 실패, 네트워크 의존 Add-in | 안전 모드 부팅→COM 추가 기능 비활성화→서명·네트워크 점검 |
| 특정 메뉴 클릭 시 강제 종료 | .xll 네이티브 Add-in 충돌, 버전 불일치 | 문제 Add-in 격리 로드→대체 버전 테스트 |
| 파일 저장/닫기 시 응답 없음 | 이벤트 훅을 거는 VBA/.xlam, DDE/외부 연결 | 해당 Add-in 제거 후 재현 테스트→DDE 차단 |
| 리본 탭 사라짐·회색 | LoadBehavior=2(비활성), 신뢰센터 정책 | 레지스트리 LoadBehavior=3 복구→신뢰 위치 설정 |
| PC 계정 변경 시만 오류 | 사용자 프로필 경로 바인딩, 권한 부족 | 사용자별 경로 수정, 서명 재신뢰 |
주의 : 동일 증상이라도 원인은 복합적일 수 있다. 하나의 조치 후에는 반드시 재현 테스트를 통해 개선 여부를 검증해야 한다.
2. Add-in 종류별 동작 차이 이해
Add-in의 유형을 구분하면 진단 순서를 최적화할 수 있다.
- COM 추가 기능 : 설치형 DLL 기반이다. 레지스트리 등록과 LoadBehavior 키에 따라 자동 로드가 결정된다.
- Excel 추가 기능(.xlam/.xla) : VBA 매크로 기반이다. 신뢰센터의 매크로 설정과 서명 신뢰가 중요하다.
- 네이티브 .xll : C/C++로 작성된 고성능 함수형 Add-in이다. 64/32비트 호환성 문제가 잦다.
- Office Web/JS Add-in : 웹 기술 기반이다. 네트워크·프록시·TLS 설정 영향을 받는다.
3. 10분 내 응급 복구 루트
- 안전 모드 실행 : 실행 창에서
excel /safe입력 후 시작한다. - 문제 범위 판정 : 안전 모드에서 문제가 사라지면 Add-in 기인 가능성이 높다.
- COM 추가 기능 비활성화 : 파일 > 옵션 > 추가 기능 > 하단 관리: COM 추가 기능 > 이동 > 모두 체크 해제 후 하나씩 켠다.
- .xlam/.xll 격리 : 파일 > 옵션 > 추가 기능 > 관리: Excel 추가 기능 > 이동에서 하나씩 해제한다.
- 정상 모드 재부팅 : 문제 Add-in을 특정할 때까지 3~4회 반복한다.
주의 : 기업 환경에서 GPO로 강제 로드되는 Add-in은 사용자 UI에서 해제가 불가하다. 이 경우 IT 관리 콘솔 또는 레지스트리 편집이 필요하다.
4. 체계적 격리 진단 절차(현장 체크리스트)
| 단계 | 점검 항목 | 합격 기준 | 실패 시 조치 |
|---|---|---|---|
| 1 | 안전 모드 재현 여부 | 안전 모드 정상 동작 | 정상→Add-in 원인 가정, 비정상→엑셀 자체·프로필 손상 의심 |
| 2 | COM 추가 기능 일괄 비활성화 | 문제 사라짐 | 하나씩 활성화하여 트리거 Add-in 특정 |
| 3 | .xlam/.xll 개별 비활성화 | 문제 사라짐 | 버전 교체·경로 이동·신뢰 위치 등록 |
| 4 | 네트워크 의존성 체크(프록시/TLS) | 오프라인에서도 안정 동작 | 엔드포인트 화이트리스트·프록시 예외 |
| 5 | 서명·매크로 정책 확인 | 신뢰된 게시자, 매크로 허용 정책 준수 | 디지털 서명 재배포, 신뢰센터 정책 조정 |
| 6 | 충돌 재현 로그 수집 | 이벤트 로그·시간대 일치 | 문제 Add-in 공급사에 로그 전달 |
5. Windows에서 COM 추가 기능 핵심 키(레지스트리)
COM 추가 기능 자동 로드는 다음 레지스트리 키와 값으로 제어한다.
HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\<ProgID>\LoadBehavior값 3: 자동 로드, 2: 비활성이다.HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Excel\Addins\<ProgID>\LoadBehavior시스템 전체 정책으로 적용된다.
PowerShell로 현재 상태를 점검한다.
# 사용자 범위 COM 추가 기능 상태 조회 Get-ChildItem "HKCU:\Software\Microsoft\Office\Excel\Addins" ` | ForEach-Object { [PSCustomObject]@{ ProgID = $_.PSChildName LoadBehavior = (Get-ItemProperty $_.PsPath).LoadBehavior } }
시스템 범위
Get-ChildItem "HKLM:\Software\Microsoft\Office\Excel\Addins" `
| ForEach-Object {
[PSCustomObject]@{
ProgID = $.PSChildName
LoadBehavior = (Get-ItemProperty $.PsPath).LoadBehavior
}
}
비활성(2)인 항목을 자동 로드(3)로 복구
Set-ItemProperty "HKCU:\Software\Microsoft\Office\Excel\Addins\Your.Addin.ProgID" -Name LoadBehavior -Value 3
주의 : 레지스트리 변경 전 시스템 복원 지점 생성 또는 내보내기를 수행해야 한다. 기업 환경에서는 GPO가 우선 적용되므로 사용자 변경이 재부팅 후 되돌려질 수 있다.
6. Excel 추가 기능(.xlam/.xll) 관리 포인트
- 신뢰 위치 : 파일 > 옵션 > 신뢰 센터 > 신뢰할 수 있는 위치에 Add-in 저장 경로를 등록한다.
- 디지털 서명 : VBA 프로젝트에 코드 서명을 적용하고 게시자를 신뢰한다.
- 버전·비트수 일치 : .xll은 엑셀과 동일한 64/32비트 빌드로 맞춰야 한다.
- 파일 잠금 : 네트워크 드라이브에서 락이 걸리면 로드 실패가 발생한다. 로컬 경로 테스트로 분리한다.
7. macOS에서의 차이점
- 안전 모드 단축 기능은 제한적이다. 문제 발생 시 도움말 > 추가 기능에서 개별 비활성화를 먼저 진행한다.
- .xlam/.xll 경로 권한과 Gatekeeper 설정이 영향을 준다. 다운로드한 파일은 컨텍스트 메뉴 > 열기로 최초 신뢰를 부여한다.
- 프로필 캐시 손상이 의심되면 ~/Library/Containers/com.microsoft.Excel 내 사용자 캐시 재설정 후 재부팅한다.
8. 성능 저하형 충돌 최적화
충돌이 아닌 체감 지연 문제는 다음 순서로 완화한다.
- 지연 로드 설정: 가능하면 Add-in의 지연 로드 옵션을 사용한다.
- 실시간 보호 예외: 신뢰된 Add-in 경로를 백신 예외에 등록한다.
- 네트워크 타임아웃: 웹 호출이 있는 Add-in은 타임아웃을 3~5초로 제한한다.
- 로그 레벨 하향: 과도한 디버그 로그는 I/O 병목을 유발한다.
9. 재현 로그 수집과 원인 고정
문제 고정화를 위한 필수 로그는 다음과 같다.
- 이벤트 뷰어 : 응용 프로그램 로그에서 Excel 오류 이벤트의 Faulting Module이 Add-in DLL인지 확인한다.
- 엑셀 시작 시간 측정 : 지연 원인을 수치화한다.
'VBA: 엑셀 시작 후 Add-in 초기화 시간 로깅 예시 #If VBA7 Then Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long #Else Private Declare Function GetTickCount Lib "kernel32" () As Long #End If
Sub LogAddinInit()
Dim t As Long: t = GetTickCount()
' Add-in 초기화 호출
' ...
Debug.Print "Init(ms): "; GetTickCount() - t
End Sub
10. 충돌 매트릭스로 원인 분류
| 조건 | 가능 원인 | 검증 방법 | 처방 |
|---|---|---|---|
| 안전 모드 OK, 정상 모드 실패 | Add-in 영향 | 개별 활성화 재현 | 문제 Add-in 업데이트 또는 제거 |
| 모든 사용자에서 동일 증상 | HKLM 정책, 공용 배포 버그 | 서버·GPO 비교 | 배포 롤백·패치 적용 |
| VPN 연결 시만 지연 | 엔드포인트 차단·DNS 지연 | Fiddler/프록시 로그 | 화이트리스트·DNS 고정 |
| 64비트 엑셀에서만 오류 | .xll 32비트 호환만 제공 | 비트수 확인 | 64비트 빌드로 교체 |
11. 신뢰센터와 보안 정책 정렬
- 매크로 설정 : 알림 표시 후 비활성화 또는 신뢰된 서명만 허용한다.
- 신뢰 위치 : 네트워크 경로는 하위 폴더 포함 체크를 주의한다.
- 개체 모델에 대한 VBA 프로젝트 신뢰 : 필요 최소 권한만 허용한다.
주의 : 무차별 허용은 보안 사고의 원인이 된다. 서명·위치·권한의 삼박자를 동시에 만족할 때만 자동 로드를 허용한다.
12. 배포·업데이트 전략
- 파일 이름에 버전 부여 : 예)
Contoso.Addin.1.4.2.xlam형태로 롤백이 쉽다. - 단계적 롤아웃 : IT·파워유저→일반 사용자 순서로 배포한다.
- 의존 라이브러리 고정 : .NET/VSTO, C 런타임 버전 표기와 설치 스크립트를 포함한다.
- 크래시 덤프 수집 : 공급사에 전달할
.dmp자동 수집 옵션을 구성한다.
13. 자주 쓰는 명령·도구 모음
# 안전 모드 실행(Windows) Win + R -> excel /safe
COM 추가 기능 대화상자 열기
파일 -> 옵션 -> 추가 기능 -> 관리: COM 추가 기능 -> 이동
레지스트리 백업
reg export "HKCU\Software\Microsoft\Office\Excel\Addins" "%USERPROFILE%\Desktop\excel_addins_backup.reg"
Office 온라인 복구(클릭-투-런)
appwiz.cpl -> Microsoft 365 -> 변경 -> 온라인 복구
14. 최종 복구 루틴(시간순 스크립트)
- 문제 재현 캡처 및 시간 기록을 확보한다.
excel /safe실행 후 문제가 사라지는지 확인한다.- COM 추가 기능을 모두 해제하고 하나씩 활성화하며 재현한다.
- .xlam/.xll도 동일 절차로 격리한다.
- 문제 Add-in 확인 시 최신 버전으로 업데이트한다.
- 서명·신뢰 위치·네트워크 예외를 정비한다.
- 여전히 실패 시 레지스트리 LoadBehavior와 GPO를 점검한다.
- 끝으로 Office 온라인 복구를 실행한다.
15. 현장 템플릿: 충돌 보고서 양식
제목: 엑셀 Add-in 충돌 보고서 사용자/부서: PC 사양/OS/엑셀 버전: Add-in 유형/버전/배포 경로: 증상(정확한 메시지/영상 링크): 재현 절차(숫자 목록): 시도한 조치(성공/실패): 로그/이벤트ID: 요청 사항(업데이트/롤백/정책 변경): 16. 예방 가이드
- 주요 릴리스 전 파일명 버전 관리와 릴리스 노트를 의무화한다.
- 코드 서명 인증서 만료 30일 전에 교체 테스트를 진행한다.
- 네트워크 종속 Add-in은 오프라인 폴백 로직을 구현한다.
- 성능 기준(예: 시작 3초, 클릭 응답 1초)을 KPI로 관리한다.
FAQ
엑셀을 켤 때마다 Add-in이 사라지거나 꺼져 있다.
레지스트리의 LoadBehavior가 2로 변경되었을 가능성이 크다. HKCU 및 HKLM의 해당 ProgID에서 LoadBehavior를 3으로 복구하고, 충돌 원인이 되는 다른 Add-in 또는 GPO 정책을 점검한다.
.xll Add-in 로드 실패 오류가 뜬다.
엑셀 비트수와 .xll 빌드가 일치해야 한다. 64비트 엑셀에는 64비트 .xll만 사용해야 하며, 누락된 런타임 의존성도 점검한다.
기업 환경에서 사용자 UI로 Add-in을 끌 수 없다.
GPO 또는 HKLM 정책으로 강제 로드 중일 수 있다. IT 관리 콘솔에서 해당 정책을 일시 해제하고 문제 재현 후 로그를 수집한다.
안전 모드에서도 문제가 지속된다.
프로필 손상이나 엑셀 자체 문제 가능성이 있다. 새 사용자 프로필로 로그인하여 재현을 확인하고, 필요 시 Office 온라인 복구를 수행한다.
서명된 .xlam인데도 차단된다.
인증서 체인이 신뢰되지 않거나 만료되었을 수 있다. 인증서 저장소에 루트/중간 인증서를 추가하고 게시자를 신뢰로 등록한다.