[.NET Core] 문제 해결: An assembly specified in the application dependencies manifest was not found:

뜬금없이 발생한 문제

밤을 새고 12시에 깨서, 배탈이 나서 화장실로 리다이렉트된 뒤 컴퓨터에 앉아 업무용 디스코드 서버를 들어가니 오늘도 역시 버그 제보가 올라와 있었습니다.
헌데, 이번 문제는 좀 특이했습니다. 240대의 동일한 환경의 컴퓨터 중 단 2대에서 문제가 발생한 것이죠.

디버깅

버그 제보에는 응용 프로그램이 실행되지 않는다고 올라옴과 동시에, 잘 되는 컴퓨터에서 통채로 복사해도 여전히 실행되지 않는다는 내용이 추가로 쓰여있었습니다. 여기서 직감적으로 느꼈습니다. 아. 이거 디펜던시 문제구나.
하지만, 정확히 어디서 문제가 생겼는지는 직접 확인해봐야 했기에, 원격으로 해당 컴퓨터에 접속해 문제를 파악하기 시작했습니다.
우선, 프로그램을 실행했습니다. 문제 없이 실행되는 것처럼 보였으나, 잠시 후 업데이트 단계에서 프로그램이 예고없이 종료되었습니다. 로그를 확인해봐도 프로그램 자체는 정상적으로 업데이터까지 실행했다고 나와있었고요.
그래서, 이번엔 업데이터를 수동으로 실행해봤습니다. 아직까지는 UI가 없는 콘솔 형태의 업데이터인지라, 프로그램이 꺼짐과 동시에 콘솔이 날아가버리는 것을 방지하기 위해 명령 프롬프트에서 실행했죠.
그랬더니 다음과 같은 에러가 보이더군요.
An assembly specified in the application dependencies manifest (####.deps.json) was not found:
여기서 의심은 확신이 되었습니다.

구글링

의심이 확신이 된 것까진 좋은데, 어떻게 해결해야 할지는 바로 감이 오지 않는 상황이었습니다. 위 업데이터는 태어나서 처음으로 .NET Core 어플리케이션을 Publish, 그것도 단일 파일로 퍼블리시한 상태이기 때문에 도대체 어디서 문제가 생긴 것인지 알 수가 없었기 때문이죠.
하지만 당연히 문제가 될 것은 없습니다. 왜냐하면 저, 그리고 여러분에겐 구글과 스택오버플로우가 있기 때문입니다. 검색을 진행했죠.
키워드: An assembly specified in the application dependencies manifest was not found:
바로 첫 번째 검색 결과에 답이 나오더군요. 바로 이 스택오버플로우 글입니다.
해당 글의 답변에 따르면, 일반적으로 개발 머신에는 SDK가 설치되지만 배포 환경에서는 런타임 디펜던시만 설치된다며 csproj 파일에 다음과 같은 엘리먼트를 추가하라고 합니다.
<PropertyGroup>
    <PublishWithAspNetCoreTargetManifest>false</PublishWithAspNetCoreTargetManifest>
</PropertyGroup>

문제는 해결됐다. 그런데 도대체 어떻게 된 것일까?

개발자라면 누구나 한 번 쯤 봤을 법한 유명한 짤이 하나 있죠.
It Doesn't Work Why? It Works Why? We knowMemes | Work Meme on ME.ME
왜? 도대체 왜 되는거지?
XML 요소의 이름에서 대충 배포시 ASP.NET Core 타겟 매니페스트를 포함하지 않겠다 정도까지는 유추할 수 있습니다. 그러나, 애초에 문제가 생긴 어플리케이션은 ASP.NET Core가 아닌, .NET Core 콘솔 응용 프로그램이었습니다.
그럼 뭐 별 수 있나요? 구글링 해야죠. 문제는 단순히 PublishWithAspNetCoreTargetManifest 키워드로 검색을 할 경우에는 스택오버플로우와 같은 사이트들만 나타나고, 정의가 어떻게 되는지에 대해서는 나오지 않았습니다. 그래서 PublishWithAspNetCoreTargetManifest MSDN이라고 검색하니 납득이 갈만한 MSDN 문서가 나왔습니다.
해당 문서의 마지막 부분을 보면 다음과 같은 문구가 있습니다.
When deploying a runtime-dependent deployment app, make sure that the target environment has the .NET Core SDK installed. If the app is deployed to an environment that doesn’t include ASP.NET Core, you can opt out of the implicit store by specifying <PublishWithAspNetCoreTargetManifest> set to false in the project file as in the following example:
런타임 의존 앱을 배포할 때에는 해당 환경에 .NET Core SDK가 설치되어 있어야 한다. 만약 배포 환경이 ASP.NET Core를 포함하지 않는다면, 프로젝트 파일의 <PublishWithAspNetCoreTargetManifest> 요소를 false로 설정해 암시적 저장소를 제외시킬 수 있다.
단순 번역으로는 무슨 소리인지 모르겠네요. 하지만 그 밑에 예문에 정답이 나와있었습니다.
Note
For self-contained deployment apps, it’s assumed that the target system doesn’t necessarily contain the required manifest packages. Therefore, <PublishWithAspNetCoreTargetManifest> cannot be set to true for an self-contained app.
단일 포함 앱을 배포할 경우에는 배포 환경에 필요한 매니페스트 패키지가 없을 것으로 가정하므로, 이 때에는 <PublishWithAspNetCoreTargetManifest>가 true로 설정되면 안 된다는 얘기입니다.
흠… 좋아요. 여기까진 이해했습니다. 그러나 아직도 이해가 되지 않는 것이 하나 있죠. 바로 저는 ASP.NET Core가 아닌, .NET Core 콘솔 앱을 만들어 게시를 사용해 배포했는데 도대체 왜 이러한 문제가 생겼는가? 입니다.
정답인지는 아직도 모르겠지만, 유추해보기로 아마 ASP.NET에서 사용되는 일부 라이브러리(Microsoft.Extensions.Configuration.Bindings 등등)를 사용해서가 아닐까 싶습니다.

결론

단일 파일 배포시 프로젝트 파일의 <PublishWithAspNetCoreTargetManifest>를 false로 설정하면 문제는 해결됩니다. 다만, 애초에 VS2019의 퍼블리싱 기능을 사용해 단일 파일 옵션을 체크하고 배포한 것인데, 알아서 좀 false로 설정됐으면 좋으련만 굳이 수동으로 설정해야 한다는 점이 아쉬울 뿐입니다.
​

댓글

댓글 쓰기

이 블로그의 인기 게시물

C# 남아도는 메모리에도 불구하고 OutOfMemoryException이 발생한다면?

이미지
  C# 코딩 중 평소 볼 수 없던 생소한 현상이 발생했습니다. 분명 메모리는 남아도는데(32기가바이트 중 26기가바이트 사용 가능) 프로그램이 돌다가 OutOfMemory 예외를 던지며 죽어버리는 현상이었죠. List 에 수많은 파싱된 데이터를 넣는 작업 중이었습니다.   그래서 메모리 프로파일러를 잘 관찰해보니 2GB의 메모리를 사용하면 무조건 뻗어버리는 현상을 발견했고, 왜 그럴까 생각해보다가 문득 예전 XP에서 4기가 메모리를 달아도 32비트 운영체제의 한계 아닌 한계로 3기가 조금 넘게밖에 인식을 못 했던 것이 생각났습니다. 생각은 자연스럽게 컴파일이 32비트로 됐구나! 쪽으로 넘어갔고 프로젝트 설정에 보니 빌드 항목에 해당되는 체크박스가 있더군요.   현재 메모리가 남아도는데도 OutOfMemory 예외가 뜬다면 100% 저게 체크된 상태일 겁니다. 그림과 같이 체크 해제 하신 후 실행하시면 특별한 경우가 아닌 이상 컴퓨터 메모리가 바닥날 때까지 저 예외를 볼 일 없게 될겁니다.
자세한 내용 보기

MySQL 데이터 타입과 Java 데이터 타입 비교/매칭

  안녕하세요? 혼살입니다. 블로그에 정말 오랜만에 글을 씁니다. 일하고 겜하고 일하고 겜하고 집에 박혀서 매일 똑같은 일상을 보내다 보니 블로그에 글을 오랫동안 안 쓰고 있었네요. 대부분 근황은 유튜브 동영상으로 대체하다 보니 더욱 더 그랬던 것 같습니다.   하지만 이번엔 영상보다 글로 남기는 게 더 유익할 것 같아 간만에 글을 쓰게 되었습니다. 바로 MySQL Data Types & Java Data Types 매칭! 현재 진행중인 외주 작업 중 SET 타입을 Java에선 어떻게 처리하나 찾아보다가 잘 정리된 블로그 글 을 발견해 나중에 손쉽게 찾기 위해 제 블로그에도 씁니다. 위 링크에 들어가시면 테이블로 잘 정리돼 있으니 한 번 들어가 보시는것도 괜찮겠네요. 왼쪽은 MySQL, 오른쪽은 Java의 데이터 타입입니다. BIT <-> Boolean TINYINT <-> Integer BOOL/BOOLEAN (TINYINT(1)) <-> Integer SMALLINT <-> Unsigned 상관없이 Integer MEDIUMINT <-> Integer, Unsinged라면 Long INT <-> Integer, Unsigned라면 Long BIGINT <-> Long, Unsigned라면 java.math.BigInteger FLOAT <-> Float DOUBLE <-> Double DECIMAL <-> java.math.BigDecimal DATE <-> java.sql.Date DATETIME <-> java.sql.Timestamp TIMESTAMP <-> java.sql.Timestamp TIME <-> java.sql.Timestamp YEAR <-> yearsIsDateType이 설정됐다면 java.sql.Date, 아니라면 Short CHA
자세한 내용 보기

테일즈위버 OST 전곡 모음

이미지
  블로그를 옮기면서 카드캡터 사쿠라 OST를 포함해 테일즈위버 OST 역시 까먹고 안 옮겼었네요. 소름... 블로그 조회수의 대부분을 차지하는 두 개를 안 옮겼었다니!   게임보다 OST들으러 들어간다는 테일즈 위버(Tales Weaver)의 모든 OST 모음집입니다. FLAC파일을 재생할 수 있는 플레이어가 필요합니다... 만 요새는 웬만해선 다 재생해주죠. 즐감하세요.
자세한 내용 보기