📚 오류 수정록 - 2025년 4월 28일 (월) / Unity Collaborate 패키지 오류 해결 기록

🎮 오늘 해결한 문제:

Unity Collaborate / Plastic SCM 패키지 관련 오류 (CS0006)

---

🔹 문제 상황

Unity 프로젝트를 실행하거나 빌드할 때, 아래와 같은 에러가 반복 발생했다.

error CS0006: Metadata file 'Library/PackageCache/com.unity.collab-proxy@2.7.1/Lib/Editor/PlasticSCM/log4netPlastic.dll' could not be found
error CS0006: Metadata file 'Library/PackageCache/com.unity.collab-proxy@2.7.1/Lib/Editor/PlasticSCM/Unity.Plastic.Antlr3.Runtime.dll' could not be found
error CS0006: Metadata file 'Library/PackageCache/com.unity.collab-proxy@2.7.1/Lib/Editor/PlasticSCM/Unity.Plastic.Newtonsoft.Json.dll' could not be found

• 프로젝트가 잘 실행되다가 갑자기 해당 오류 발생.
• 새로 만든 프로젝트에서도 동일한 오류 재현.
• Unity 재설치 이후에도 문제가 지속됨.

---

🔹 원인 분석

1. Collaborate / Plastic SCM 패키지 자동 포함
   • Unity는 새 프로젝트 생성 시 기본적으로 com.unity.collab-proxy 패키지를 포함시킴.
   • Git만 사용하는 환경에서는 불필요한 패키지.
2. 패키지 캐시 손상
   • 해당 패키지의 DLL 파일들이 누락되거나 손상되면서 에러 발생.
3. 프로젝트 설정 문제
   • 단순히 Unity를 재설치해도, 프로젝트 내부 설정이 유지되므로 문제가 반복됨.

---

🔹 해결 방법

1. Packages/manifest.json 파일에서 아래 항목 삭제.

"com.unity.collab-proxy": "2.7.1",

1. 프로젝트 루트 폴더에서 Library 폴더 삭제.
2. Unity 재실행.
3. Window > Package Manager 에서 Collaborate/Version Control 패키지 제거 확인.

---

🔹 배운 점

• Unity는 새 프로젝트 생성 시 불필요한 패키지가 자동 포함될 수 있으므로, 초기 패키지 정리 습관화 필요.
• Collaborate / Plastic SCM은 Git 환경에서 무조건 제거하는 것이 좋다.
• 문제가 발생했을 때 재설치보다, 먼저 프로젝트 설정 파일(manifest.json) 과 패키지 매니저 점검이 우선.

---

🔹 앞으로의 계획

• 새 프로젝트 생성 시 초기 패키지 정리 루틴 적용.
• Git만 사용하는 환경에서는 Version Control 관련 패키지 즉시 제거.
• 동일한 오류 발생 시 당황하지 않고 원인부터 빠르게 점검할 것.