Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

vite-plugin: SSR function import path is wrong when Vite root is a subdirectory (relative build.outDir resolved against cwd)

Aperta Adatta ai principianti
  • Qualcosa non va?
#68 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript, vite
Ambito
build-system

Direzione di ricerca

Inizia in dist/main.js, intorno alla logica di writeBundle che usa l’ambiente build.outDir, quindi esegui la riproduzione segnalata con pnpm run build dalla root del repository. È completato quando web/.netlify/v1/functions/server.mjs usa l’import relativo corretto e il bundling di Netlify Functions risolve server.js per una root Vite in una sottodirectory.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Environment

  • @netlify/vite-plugin-tanstack-start 1.3.19 (bundles @netlify/vite-plugin 3.0.1)
  • @tanstack/react-start 1.168.54
  • vite 8.3.0
  • Node 24, pnpm

Summary

When the Vite root is a subdirectory of the repository and the build runs from the repository root, the generated SSR function gets an extra ../ in its import specifier.

# web/.netlify/v1/functions/server.mjs (generated)
import serverEntrypoint from "../../../../dist/server/server.js";

# expected
import serverEntrypoint from "../../../dist/server/server.js";

Netlify's Functions bundling then fails:

◈ Functions bundling
◈ Packaging Functions from web/.netlify/v1/functions directory:
 - server.mjs
X [ERROR] Could not resolve "../../../../dist/server/server.js"
    web/.netlify/v1/functions/server.mjs:1:29

This makes the SSR/API function undeployable for this layout. The same wrong specifier is produced regardless of whether the directory is discovered as a framework function (<base>/<package>/.netlify/v1/functions) or via [functions] directory.

How to reproduce

Repo layout where Vite root is a subdirectory but the build is invoked from the repo root:

repo/
├─ netlify.toml           # [build] command = "pnpm run build"
├─ package.json           # "build": "vite build --config web/vite.config.ts"
└─ web/
   ├─ vite.config.ts      # root: <web/>
   └─ src/...

web/vite.config.ts:

export default defineConfig({
  root: rootDir, // web/
  plugins: [tanstackStart(), netlify(), react()],
});

Then:

pnpm run build           # from repo root, process.cwd() !== config.root
cat web/.netlify/v1/functions/server.mjs

Cause

@netlify/vite-plugin dist/main.js (build plugin):

async writeBundle(_, bundle) {
  const functionsDirectory = join(resolvedConfig.root, NETLIFY_FUNCTIONS_DIR);
  const serverEntrypoint = getServerEntrypoint(bundle, this.environment.config.build.outDir);
  const serverEntrypointRelativePath = toPosixPath(relative(functionsDirectory, serverEntrypoint));
  // ...
}

this.environment.config.build.outDir is a relative value here (dist/server): TanStack Start's plugin derives the per-environment output directory as join(userConfig.build?.outDir ?? 'dist', 'server') (@tanstack/start-plugin-core vite/output-directory.ts), so the environment config keeps it relative.

path.relative(from, to) resolves a relative to against process.cwd(). When process.cwd() !== config.root, the entry path resolves to <repo>/dist/server/server.js instead of <repo>/web/dist/server/server.js, producing one extra ../.

In a project where cwd === root this happens to work, which is why it only shows up with a subdirectory root.

Suggested fix

Resolve the output directory against the Vite root before computing the relative path:

const outDir = isAbsolute(this.environment.config.build.outDir)
  ? this.environment.config.build.outDir
  : resolve(resolvedConfig.root, this.environment.config.build.outDir);
const serverEntrypoint = getServerEntrypoint(bundle, outDir);

Workaround

Setting an absolute build.outDir in vite.config.ts avoids the issue:

build: { outDir: path.join(rootDir, "dist") }

but it would be good not to require that.

Lingua principale
TypeScript
Stelle
1
Fork
4
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di netlify/framework-adapters

Tutte le issue di netlify/framework-adapters

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.