release: Next.js 배포에서 커밋된 config 가 이겨 산출물이 나오지 않던 문제 수정

[dldnsgkr]

develop → main. #172 하나뿐이고 마이그레이션 변경은 없다.

무엇을 고치나

create-next-app 은 스캐폴딩 때 next.config.mjs 를 항상 만든다. 그런데 배포 워크플로는 config 가 없을 때만 만들고 있으면 경고만 남겼다. 그래서 생성 분기는 현실에서 거의 발화하지 않고 커밋된 config 가 유일한 진실이 된다.

그 config 에는 output: 'export' 가 없다. next build 는 .next 만 만들고 ./out 은 생기지 않으므로 publish 스텝이 그 디렉터리를 찾다 실패한다 — 이슈 제목의 "자산 404" 이전에 배포 자체가 끝까지 가지 못한다.

해결 — 덮어쓰지 않고 감싼다

사용자의 config 를 지우지 않고 옆으로 옮긴 뒤, 그것을 불러와 우리가 소유하는 세 필드만 얹는다. 파싱하지 않으므로 형식(JS/MJS/TS)이나 내용에 기대지 않고, 사용자가 적은 redirects·env·webpack 설정은 그대로 살아남는다.

output 과 images.unoptimized 는 GitHub Pages 가 정적 호스팅이라는 사실에서, basePath 는 배포 URL 에서 나온다 — 셋 다 사용자가 정할 수 있는 값이 아니다.

실측 (워크플로 셸 로직을 그대로 실행)

입력	결과
ESM .mjs (reactStrictMode, env)	유지 + 세 필드 적용
CJS .js (images.formats), 커스텀 도메인	formats 유지 + unoptimized, basePath: ""
함수형 () => ({...})	평가해서 병합

basePath 는 trailing slash 가 없어야 해서 QEPLOY_BASE_PATH 를 따로 넘긴다(기존 BASE_PATH/PUBLIC_URL 은 slash 포함). TypeScript 는 .ts 확장자 import 를 허용하지 않아 import 경로를 확장자에 따라 가른다.

범위

Next.js 로 한정했다. CODE 프롬프트가 제시하는 넷(Vite+React, CRA, Vue, Next.js) 중 깨지는 것은 이것 하나이고, 나머지는 vite build --base 나 homepage 덮어쓰기로 이미 배포 시점 값이 이긴다. gatsby·sveltekit·astro·nuxt·vue-cli 는 기존 저장소 연결에서만 등장하므로 #116 을 열어둔다.

검증

• 마이그레이션 없음. 워크플로 템플릿과 테스트만 바뀐다
• 테스트 4개 추가, ./gradlew test 전체 통과
• CI 통과, dev 배포 성공(bc37c6a) 및 기동 확인

기존 저장소는 다음 배포부터 적용된다 — 워크플로 파일은 배포 때마다 ensureWorkflow 가 다시 쓴다.

🤖 Generated with Claude Code