🧨 "로컬에서는 잘 되는데요?" Electron 배포에서 터진 exe 실행 오류

로컬에서는 잘 되던 Engine.exe가

배포만 하면…

🥶 "엔진 파이프에 연결되어 있지 않습니다."

Electron으로 만든 데스크탑 앱을 .exe로 패키징해서 배포했을 때 있었던 실제 사건입니다.

---

🤔 “로컬에서는 완벽했는데…”

분명 개발 중에는 아무 문제 없었습니다.

• 엔진 잘 뜨고
• Named Pipe도 잘 붙고
• JSON 읽고 쓰고 삭제도 찰떡같이 되더니…

배포하면? 갑자기 연결이 안 됩니다.

---

🔍 문제 1: asar 안에 들어간 exe는 못 실행합니다

처음엔 이렇게 코드를 짰었죠.

const enginePath = path.join(__dirname, 'public', 'Engine.exe')

로컬에서는 이게 잘 작동합니다.

하지만 Electron Builder가 배포용으로 빌드할 때는…

C:\Users\...\resources\app.asar\public\Engine.ex

app.asar 안에 압축돼버리죠.

문제는 이 상태에서는 .exe 실행이 안 된다는 것!

---

🛠 해결 1: extraResources + unpack 옵션 추가

그래서 이렇게 electron-builder 설정을 고쳤습니다.

"build": {
  "extraResources": [
    {
      "from": "public",
      "to": "public",
      "filter": ["**/*"],
      "unpack": true}
  ]

그리고 코드에서 경로는 아래처럼 변경했습니다.

const enginePath = path.join(process.resourcesPath, 'app.asar.unpacked', 'public', 'Engine.exe');

이제 드디어 배포 버전에서도 exe가 실행될 줄 알았습니다.

그런데...

---

😡 문제 2: 언팩도 했는데, 여전히 안 돌아간다고요?

분명히 app.asar.unpacked에 잘 들어가 있는데도 실행이 안 되는 겁니다.

그래서 직접 cmd를 열어서 엔진 경로로 가서 실행해봤습니다.

cd C:\Users\...\resources\app.asar.unpacked\public\
./seph_engine.exe

어랏? 🤯 수동 실행은 되네?

그러니까 문제는 파일이 없어서가 아니라 Electron이 실행을 못 시킨다는 거였던 겁니다.

---

📦 배포하고 spawn 호출했더니?

아무 일도 일어나지 않았습니다.

아무런 에러도 없이, 아무것도 실행되지 않는 spawn.

Logger.info(`[ENGINE] spawn 성공, PID: ${engineProcess.pid}`);

PID: undefined 👀

아니 뭐…?

---

😡 “엔진이 죽었습니다”

엔진이 안 돌아가니 Pipe도 연결이 안 됩니다.

[PIPE] reqClient가 null입니다.
[PIPE] reqClient는 writable하지 않습니다.

그리고 사용자에게는 이런 메시지로 가죠.

⚠️ “엔진 파이프에 연결되어 있지 않습니다.”

---

🔬 디버깅 시작: spawn이 문제였다고?

Electron에서 spawn()은 외부 실행파일을 직접 실행합니다.

하지만 배포 버전에서는 보안 정책 + 경로 문제 + 권한 문제로 인해…

💣 "spawn이 작동 안 합니다"

심지어 경로도 완벽하게 언팩해놨는데요?

C:\Users\me\AppData\Local\Programs\MyApp\resources\app.asar.unpacked\public\seph_engine.exe

이거를 수동으로 cmd에서 실행하면 되는데요?!

Electron만 못합니다 😱

---

🛠 해결 2: 그래서 결국 exec("start /B")로 해결했습니다

const command = `start /B "" "${enginePath}"`;
exec(command, { cwd: engineDir, windowsHide: true });

start /B는 윈도우 CMD 명령어로 "CMD에서 백그라운드로 실행하라"는 뜻입니다.

Electron이 직접 실행하진 않지만, CMD가 대신 실행해주는 방식입니다.

윈도우에서는 이게 오히려 더 확실하게 실행되더군요.

✔️ 그리고 이 방법으로 드디어 배포에서도 완벽하게 돌아갔습니다!

---

✨ 최종 요약

문제	해결 방법
.exe 실행 실패	app.asar.unpacked에 넣기 + process.resourcesPath 사용
실행은 되는데 Electron이 못 실행함	exec("start /B ...") 방식으로 CMD 강제 실행

---

😅 마무리하며

개발자 여러분…

“로컬에서는 잘 됐습니다만…”

이 말, 이제 입에 올리지 맙시다…

Electron은 배포가 반입니다. 아니, 배포가 진짜 전쟁입니다. 🪖

혹시 여러분도 배포에서 .exe 실행이 안 돼서 고통받고 계신다면

위 방법 꼭 시도해보세요. 제 반나절을 아낄 수 있습니다 🙏