[Cloudflare Adapter] SSR build generates incorrect import paths - files in dist/_astro but worker imports from dist/_worker.js/_astro

[jroth55]

Astro Info

Astro: 5.16.3
@astrojs/cloudflare: 12.6.3
Node: v22.x
Package Manager: pnpm 10.11.0

Describe the Bug

When building an Astro project with the Cloudflare adapter in hybrid mode, the generated dist/_worker.js/index.js contains import paths that reference files in dist/_worker.js/_astro/, but the actual files are generated in dist/_astro/.

Example of the incorrect import in dist/_worker.js/index.js:

import { renderers } from './_astro/_@astrojs-ssr-adapter.o5tssWKZ.js';

Actual file location:

dist/_astro/_@astrojs-ssr-adapter.o5tssWKZ.js

Expected file location (per the import):

dist/_worker.js/_astro/_@astrojs-ssr-adapter.o5tssWKZ.js

This causes deployment to Cloudflare Pages to fail with module resolution errors.

Steps to Reproduce

1. Create a new Astro project with hybrid output mode
2. Add @astrojs/cloudflare adapter with config:

// astro.config.mjs
import { defineConfig } from 'astro/config';
import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
  output: 'hybrid',
  adapter: cloudflare({
    platformProxy: { enabled: true },
    routes: { strategy: 'auto' }
  })
});

3. Run pnpm build
4. Observe that dist/_worker.js/index.js imports from ./_astro/ path
5. Observe that actual files are in dist/_astro/ not dist/_worker.js/_astro/
6. Deploy with wrangler pages deploy dist fails with: Could not resolve "./_astro/_@astrojs-ssr-adapter..."

Expected Behavior

Either:

1. The import paths in dist/_worker.js/index.js should reference ../_astro/ (going up one level), OR
2. The SSR adapter files should be copied/generated into dist/_worker.js/_astro/

Current Workaround

We use a post-build script that copies files:

// fix-worker-imports.mjs
import { cpSync, existsSync } from 'fs';
import { join } from 'path';

const distDir = './dist';
const astroDir = join(distDir, '_astro');
const workerAstroDir = join(distDir, '_worker.js', '_astro');

if (existsSync(astroDir)) {
  cpSync(astroDir, workerAstroDir, { recursive: true });
  console.log('Copied _astro to _worker.js/_astro');
}

Then in package.json:

"build": "astro build && node fix-worker-imports.mjs"

Environment

• OS: macOS
• Node: v22.x
• pnpm: 10.11.0
• Deployment: Cloudflare Pages

Additional Context

This bug was also reported in #13163 but was closed as needs-repro. This issue provides a clear reproduction and workaround. This is a critical bug that prevents deployment to Cloudflare Pages without workarounds.

[florian-lefebvre]

Can you provide a github repository so we can triage this more easily? That would help a lot

[github-actions]

Hello @jroth55. Please provide a minimal reproduction using a GitHub repository or StackBlitz. Issues marked with needs repro will be closed if they have no activity within 3 days.

[jroth55]

Can you provide a github repository so we can triage this more easily? That would help a lot

yes no problem!
https://github.com/jroth55/msa-website

Here is the list of bugs I've encountered while working on Cloudflare+Astro, this is the primary one though.
BUG_REPORT.md

[florian-lefebvre]

Thanks!

[florian-lefebvre]

output: hybrid was removed in v5 FYI. And the github repository you linked is not a minimal reproduction but your entire project. That makes finding the bug very difficult, this is why we ask for a minimal reproduction

[github-actions]

Hello @jroth55. Please provide a minimal reproduction using a GitHub repository or StackBlitz. Issues marked with needs repro will be closed if they have no activity within 3 days.

[jroth55]

I'm sorry I will get a new link with the minimal reproduction

[jroth55]

Quick minimal repro (Astro 5.16.4, @astrojs/cloudflare 12.6.12, wrangler 4.53.0):

• Repo: https://github.com/jroth55/astrobug (single page, Tailwind v4 via @tailwindcss/vite).
• Config detail that triggers the failure: custom Rollup output names in astro.config.mjs:

build: {
  rollupOptions: {
    output: {
      chunkFileNames: "_astro/[name].[hash].js",
      assetFileNames: "_astro/[name].[hash][extname]",
    },
  },
},

• With that block present, dist/_worker.js/renderers.mjs imports ./_astro/astro/server..js but _worker.js/_astro is never emitted. Running node -e "import("./dist/_worker.js/index.js")" → ERR_MODULE_NOT_FOUND .../_worker.js/_astro/astro/server..js.
• Removing that Rollup output override makes the worker import from _worker.js/chunks/... and the missing-module issue disappears (keeping output: "server").

Steps to reproduce:

1. npm install
2. npm run build
3. node -e "import("./dist/_worker.js/index.js")" → missing _worker.js/_astro module.
4. Delete the Rollup output block above, rebuild, and the module resolves.

Hope that helps isolate the adapter-path issue.