이 글의 목적은 Microsoft 365 및 Office 2016/2019/2021 환경에서 Outlook·Excel·Word 등의 추가 기능(애드인) 호환성 문제를 체계적으로 진단하고 안전하게 해결하도록 돕는 것이다.
1. 추가 기능 유형 이해와 문제 범위 정의
Office 추가 기능은 설계 방식에 따라 동작 환경과 의존성이 다르므로 유형 식별이 우선이다.
- COM/VSTO(add-in): 로컬에 설치되며 .NET 런타임과 레지스트리에 종속된다.
- 웹 애드인(Office Add-ins, Manifest XML): Microsoft Edge WebView2 기반의 웹 컨트롤과 Office.js API에 의존한다.
- Outlook 전용 모델: COM/VSTO, 웹 애드인, EWS/Graph 연동형이 혼재한다.
주요 증상은 시작 시 느려짐, 기능 리본 사라짐, 보안 경고, 무응답, “로드 실패” 메시지, 보호된 보기 전환, 회색으로 비활성화됨 등이 있다.
주의 : 유형별 요구사항을 혼동하면 불필요한 재설치가 반복되며 데이터 손상 위험이 증가한다. 먼저 유형을 확정한 뒤 최소 변경 원칙으로 접근해야 한다.
2. 10분 내 1차 원인파악: 체크리스트
| 항목 | 확인 방법 | 판별 기준 | 대응 |
|---|---|---|---|
| Office 안전 모드 | Win+R → outlook /safe, excel /safe, winword /safe | 안전 모드에서 정상 동작하면 추가 기능 충돌 가능성이 높다. | 문제 애드인을 선별 비활성화한다. |
| 최근 업데이트 | 계정 → 제품 정보 → 업데이트 기록 | 업데이트 직후 오류 재현 시 호환성·API 변경 영향 가능성이 있다. | 롤백 또는 최신 패치 적용을 비교한다. |
| 실행 권한 | 표준 사용자/관리자 계정 차이 재현 | 권한에 따라 로드 여부가 달라지면 레지스트리·폴더 권한 이슈이다. | 설치/캐시 폴더 ACL을 정정한다. |
| .NET/런타임 | 앱 및 기능, dotnet --info, WebView2 런타임 존재 | 누락·구버전이면 로드 실패·UI 공백이 발생한다. | 필수 런타임 재설치 또는 업데이트를 수행한다. |
| 보안 설정 | 신뢰 센터·기업 정책·안티바이러스 이벤트 | 매크로/애드인 차단 정책 적용 시 항상 재현된다. | 신뢰 경로·서명 신뢰·예외 등록을 조정한다. |
3. 증상별 원인-해결 매핑
| 증상 | 가능 원인 | 핵심 확인 | 권장 조치 |
|---|---|---|---|
| 리본 메뉴 사라짐 | 비활성화 목록 등록, 로드 실패 | 파일 → 옵션 → 추가 기능 → 관리 | 비활성 목록에서 체크 해제 후 재시작한다. |
| Outlook 느려짐·멈춤 | 다중 애드인 충돌, 오래된 COM 애드인 | 안전 모드 정상 여부 | 문제 애드인 1개씩 비활성화하며 이분 탐색한다. |
| “로드 실패” 메시지 | .NET/VC++ 재배포 가능 패키지 누락 | 이벤트 뷰어, 로드 예외 코드 | 필수 런타임 설치 후 복구를 수행한다. |
| 웹 애드인 빈 화면 | WebView2 손상, 프록시·SSL 검사 충돌 | 다른 사용자 프로필·네트워크에서 재현 | WebView2 재설치와 보안 제품 예외를 등록한다. |
| 보안 경고·매크로 차단 | 서명 미신뢰, GPO 차단 | 서명 상태와 정책 적용 여부 | 신뢰할 수 있는 게시자로 등록하고 정책을 조정한다. |
| 클라이언트만 오류 | 프로필·캐시 손상 | 신규 사용자 프로필에서 정상 | 캐시 폴더 초기화 후 재배포한다. |
4. 안전 모드와 선택적 비활성화를 통한 충돌 분리
안전 모드에서 정상 동작한다면 문제는 높은 확률로 특정 애드인에 한정된다. 다음 순서로 이분 탐색을 수행한다.
- 파일 → 옵션 → 추가 기능 → 하단 “관리: COM 추가 기능” → 이동에서 모든 체크를 해제한다.
- 기본 기능이 정상인지 확인한다.
- 애드인을 하나씩 켠 뒤 재현 여부를 확인한다.
- 문제 애드인이 특정되면 최신 버전 교체와 의존 런타임 점검을 진행한다.
주의 : 다중 애드인을 동시에 재활성화하면 원인 역추적이 불가능해진다. 반드시 1개 단위로 변화시켜야 한다.
5. WebView2·.NET·VC++ 등 필수 구성요소 점검
웹 애드인은 Microsoft Edge WebView2 런타임에 의존하며, COM/VSTO 애드인은 .NET Framework 또는 .NET 데스크톱 런타임과 VC++ 재배포 가능 패키지를 요구한다. 다음을 점검한다.
- 앱 및 기능에서 WebView2 런타임이 설치되어 있는지 확인한다.
앱 및 기능또는winget list로 .NET Desktop Runtime과 VC++ 패키지를 확인한다.- 기업 환경의 SSL 검사·프록시가 WebView2 트래픽을 차단하지 않는지 점검한다.
# WebView2 런타임 프로세스 확인 tasklist | findstr /i msedgewebview2
.NET 런타임 버전 확인
dotnet --info
VC++ 재배포 가능 패키지 설치 확인(일부 환경)
wmic product get name,version | findstr /i "Visual C++"
6. 신뢰 센터·정책·서명: 보안 차단 해소
기업 정책이나 신뢰 설정으로 애드인이 차단되는 경우가 많다. 다음 항목을 순차 점검한다.
- 파일 → 옵션 → 보안 센터 → 보안 센터 설정 → 추가 기능: “애드인 사용 안 함”이 해제되어야 한다.
- 매크로 설정에서 “전자서명이 있는 매크로만 실행”을 사용하는 경우 게시자 인증서를 신뢰할 수 있는 게시자로 등록한다.
- 웹 애드인의 경우, 매니페스트 URL 및 콘텐츠 도메인이 방화벽·프록시 예외에 포함되어야 한다.
주의 : 서명이 없는 VSTO/COM 애드인을 광범위하게 허용하면 피싱·랜섬웨어 위험이 증가한다. 반드시 코드 서명 채택을 권장한다.
7. Outlook 특화 문제 해결 절차
Outlook은 다수의 통합 지점과 검색·인덱싱·프로필 요소가 얽혀 있어 충돌이 빈번하다. 다음 순서로 처리한다.
- 새 프로필 생성 후 동일 애드인 로드 여부를 확인한다.
- 인덱싱 상태 확인 후 지연·멈춤이 해소되는지 본다.
- OST 용량 초과·네트워크 지연이 애드인 호출에 영향을 주는지 점검한다.
- 문제 애드인을 격리한 뒤 최신 버전으로 교체한다.
# Outlook 인덱스 상태 확인 control /name Microsoft.IndexingOptions
Outlook 안전 모드
outlook /safe
8. 레지스트리·폴더 권한과 로드 동작
COM/VSTO 애드인은 레지스트리와 설치 폴더 권한에 민감하다. 표준 사용자가 쓰기 권한을 갖지 못하면 업데이트 실패와 로드 오류가 발생한다.
| 경로 | 용도 | 점검 포인트 |
|---|---|---|
HKCU\Software\Microsoft\Office\<App>\Addins | 사용자 범위 로드 상태 | LoadBehavior 값(3=자동 로드) 확인한다. |
HKLM\Software\Microsoft\Office\<App>\Addins | 컴퓨터 범위 로드 상태 | 권한과 값 상속 여부를 확인한다. |
%LOCALAPPDATA%\Apps\2.0 등 | VSTO 캐시·클릭원스 | 손상 시 캐시 초기화가 필요하다. |
reg query "HKCU\Software\Microsoft\Office\Outlook\Addins" /s reg query "HKLM\Software\Microsoft\Office\Outlook\Addins" /s
LoadBehavior 를 3으로 설정(테스트 환경 전용)
reg add "HKCU\Software\Microsoft\Office\Outlook\Addins{ProgID}" /v LoadBehavior /t REG_DWORD /d 3 /f
주의 : 레지스트리 변경은 표준 운영 지침에 따라 사전 백업과 변경 이력을 남겨야 한다. 무분별한 편집은 복구 불가능한 상태를 초래할 수 있다.
9. 캐시 초기화와 클린 부팅
손상된 캐시·임시파일은 재현률이 높다. 다음 절차로 안전하게 초기화한다.
# Office 임시 추가 기능 캐시 초기화(사용자 프로필) rd /s /q "%LOCALAPPDATA%\Microsoft\Office\16.0\Wef" rd /s /q "%LOCALAPPDATA%\Microsoft\Office\Addins"
VSTO/ClickOnce 캐시 초기화
rd /s /q "%LOCALAPPDATA%\Apps\2.0"
클린 부팅으로 타 서비스 충돌 검증(msconfig)
msconfig
기업 환경에서는 소프트웨어 배포 도구로 캐시 삭제 스크립트를 테스트 그룹에만 단계 적용한다.
10. 네트워크·프록시·SSL 검사 영향
웹 애드인은 외부 콘텐츠를 호출하므로 프록시 인증, SSL 중간자 검사, SSO 쿠키 정책이 로드에 직접 영향을 준다.
- 시스템 프록시 자동 구성 스크립트(PAC) 적용 시 예외 도메인 테스트를 수행한다.
- SSL 검사 장비가 WebView2 트래픽을 복호화하는지 확인하고, 정책에 맞게 예외를 구성한다.
- 조건부 액세스 정책의 세션 제어가 Office 클라이언트 내 프레임에 적용되는지 확인한다.
11. 배포 모델과 업데이트 전략
클릭투런(CTR) 채널과 애드인 배포 버전 간 비동기 업데이트는 호환성 문제의 주요 원인이다. 다음 원칙을 권장한다.
- 운영·파일럿·개발 3개 링으로 나누어 Office 클라이언트와 애드인을 단계 배포한다.
- 웹 애드인은 매니페스트 버전·권한 스코프 변경 시 사전 검증을 필수화한다.
- COM/VSTO는 코드 서명 갱신과 런타임 버전 핀 고정 정책을 운영 환경에 문서화한다.
12. 개발자·벤더 협업 시 제공해야 할 진단 자료
문제 재현과 근본 원인 분석을 가속하기 위해 다음 로그를 수집한다.
- 문제 시각, 앱 버전, 채널, 윈도우 빌드, 프록시·보안 제품 정보
- 이벤트 뷰어 애플리케이션 로그, WebView2 런타임 디버그 로그
- VSTO 로드 예외 스택, 로드 플래그, 레지스트리 Export
- 정책 결과 집합(RSoP) 또는
gpresult /h리포트
# 정책 결과 보고서 gpresult /h "%USERPROFILE%\Desktop\gpresult.html" /f
이벤트 로그 내보내기(응용 프로그램)
wevtutil epl Application "%USERPROFILE%\Desktop\AppLog.evtx"
13. 표준 운영 절차(SOP) 예시
1) 안전 모드 부팅으로 재현 여부 확인 2) 추가 기능 전체 비활성화 후 기본 기능 점검 3) 애드인 1개씩 활성화하며 원인 특정 4) 유형별 의존성(WebView2, .NET, VC++) 검사 5) 신뢰 센터·기업 정책 확인 및 서명 신뢰 설정 6) 캐시 초기화와 프로필 재생성으로 로컬 이슈 배제 7) 네트워크·프록시·SSL 검사 정책 점검 8) 벤더 최신 버전 교체 또는 롤백 A/B 테스트 9) 운영 링에 따라 단계 배포 및 모니터링 14. 자주 묻는 실수와 예방 팁
- 증상만 보고 무작정 재설치를 반복하는 실수는 비효율적이다.
- 여러 애드인을 동시에 업데이트하면 회귀 원인 추적이 불가능해진다.
- 코드 서명이 만료된 상태로 배포하면 조직 전반 차단이 발생한다.
- 프록시·SSL 검사 정책 변경 후 사전 회귀 테스트를 생략하면 웹 애드인이 공백 화면으로 나타난다.
주의 : 업무 중단이 큰 부서에 대해서는 변경 동결 기간을 운영하고 긴급 예외 승인 절차를 사전에 합의해야 한다.
15. 현장 점검 체크리스트(프린트용)
| 체크 항목 | 방법 | 결과 |
|---|---|---|
| 안전 모드 정상 | /safe 실행 | □예 □아니오 |
| 문제 애드인 특정 | 이분 탐색 | □완료 □미완 |
| WebView2 정상 | 프로세스·앱 확인 | □예 □아니오 |
| .NET/VC++ 충족 | 버전 점검 | □예 □아니오 |
| 신뢰 설정 검토 | 신뢰 센터·서명 | □예 □아니오 |
| 정책 영향 배제 | RSoP·gpresult | □예 □아니오 |
| 캐시 초기화 | WEF·ClickOnce | □예 □아니오 |
| 네트워크 영향 | 프록시·SSL 검사 | □예 □아니오 |
16. 트러블슈팅 스크립트 모음
:: Office 웹 애드인 캐시 초기화(사용자 세션) @echo off set WEF=%LOCALAPPDATA%\Microsoft\Office\16.0\Wef if exist "%WEF%" rd /s /q "%WEF%" echo Cleared: %WEF%
:: VSTO/ClickOnce 캐시 초기화
set C2=%LOCALAPPDATA%\Apps\2.0
if exist "%C2%" rd /s /q "%C2%"
echo Cleared: %C2%
:: Outlook 안전 모드 테스트
start "" "outlook.exe" /safe
17. 벤더 커뮤니케이션 템플릿
제목: [긴급] Office 추가 기능 호환성 이슈 진단 로그 첨부
증상 요약: 앱/버전, 채널, 재현 시점
영향 범위: 사용자 수, 부서, 업무 영향
재현 절차: 단계별 스텝과 기대/실제 결과
진단 자료: AppLog.evtx, gpresult.html, 레지스트리 Export, 스크린샷
환경 정보: OS/빌드, 프록시/SSL 검사, WebView2/.NET/VC++ 상태
임시 우회: 안전 모드 정상, 특정 애드인 비활성화 시 정상
요청: 회귀 가능성 포함한 패치 ETA 및 대체 버전 제공
FAQ
안전 모드에서만 정상인데 무엇을 먼저 봐야 하나?
추가 기능 충돌 가능성이 가장 높다. 추가 기능을 전부 끈 뒤 하나씩 활성화하며 문제를 재현하고, 특정되면 해당 애드인의 업데이트·런타임·서명·정책을 순서대로 점검한다.
웹 애드인이 빈 화면일 때 가장 흔한 원인은 무엇인가?
WebView2 손상·구버전, 프록시·SSL 검사 정책, 콘텐츠 도메인 차단이 다빈도이다. 런타임 재설치와 보안 장비 예외 등록으로 해결되는 사례가 많다.
레지스트리 LoadBehavior 값이 자꾸 2로 바뀐다. 왜 그런가?
Office가 로드 예외를 감지하면 자동 비활성화하면서 값을 변경한다. 근본 원인을 해결하기 전 강제로 3으로 고정하면 반복 충돌과 성능 저하가 발생한다.
기업 환경에서 서명이 없는 애드인을 허용해도 되나?
권장하지 않는다. 서명 없는 배포는 공급망 위협에 취약하다. 게시자 코드 서명과 신뢰할 수 있는 게시자 등록을 표준으로 채택해야 한다.
Office와 애드인 업데이트를 동시에 하면 안 되는가?
가능하나 회귀 추적이 어렵다. 운영 링을 분리하여 순차 배포하고 장애 시 롤백 포인트를 명확히 유지해야 한다.