React Router v7 Pre-render + Netlify 호환 이슈 해결 과정

요청 → 이미 생성된 HTML 반환 (SSR 불필요, CDN에서 바로 서빙)

[일반적인 구조]
vite build → server-build 생성 → prerender가 server-build 로드 → HTML 생성

[커스텀 서버 구조]
vite build → server-build 생성
           → custom server entry 생성
 
prerender는 server-build만 로드 → custom server entry 무시됨!

[react-router] Server build file not found in manifest

// node_modules/@netlify/vite-plugin-react-router/dist/index.js
config.build.rollupOptions.input = {
  server: "virtual:netlify-server"
};

export default defineConfig(({ isSsrBuild }) => ({
  build: {
    rollupOptions: isSsrBuild
      ? { input: ['virtual:react-router/server-build'] }
      : undefined,
  },
}));

// vite.config.ts
import { reactRouter } from '@react-router/dev/vite';
import { defineConfig } from 'vite';
import tsconfigPaths from 'vite-tsconfig-paths';
import netlifyReactRouter from '@netlify/vite-plugin-react-router';
import netlify from '@netlify/vite-plugin';
 
export default defineConfig({
  plugins: [
    reactRouter(),
    tsconfigPaths(),
    netlifyReactRouter(),
    netlify(),
 
    // Prerender fix: server-build를 rollup input에 추가
    {
      name: 'add-server-build-to-input',
      enforce: 'post',
      config(config, { command, isSsrBuild }) {
        if (isSsrBuild && command === 'build') {
          const currentInput = config.build?.rollupOptions?.input;
          if (currentInput && typeof currentInput === 'object') {
            return {
              build: {
                rollupOptions: {
                  input: {
                    ...currentInput,
                    'server-build': 'virtual:react-router/server-build',
                  },
                },
              },
            };
          }
        }
      },
    },
  ],
});

build/server/server.js                         0.35 kB
build/server/assets/server-build-lv_U4l46.js  14.57 kB  ← 추가됨!
 
Prerender (html): / -> build/client/index.html
✓ built in 292ms

// Before (문제)
config.build.rollupOptions.input = {
  server: "virtual:netlify-server"
};
 
// After (수정)
const existingInput = config.build?.rollupOptions?.input;
// ... 기존 input 형태에 따라 병합 처리
config.build.rollupOptions.input = {
  ...mergedInput,
  server: "virtual:netlify-server",
};