如何将依赖打包到可移植的Astro SSR服务器中？

你的Astro配置已经启用了server输出和standalone模式，但默认情况下Astro只会把服务器代码和必要依赖拷贝到dist/server，并不会将所有依赖打包进单个文件。要实现类似esbuild打包Node.js项目的单文件独立运行效果，可以通过以下两种方式实现：

方案一：Build后用esbuild二次打包（最简单直接） #

1. 保持原有Astro配置不变，先执行npm run build生成基础的服务器文件
2. 安装esbuild作为开发依赖：

npm install esbuild --save-dev

3. 在项目根目录创建打包脚本bundle-server.js，内容如下：

import { build } from 'esbuild';

await build({
  entryPoints: ['./dist/server/entry.mjs'],
  outfile: './dist/server/bundled-entry.mjs',
  platform: 'node',
  bundle: true,
  format: 'esm',
  // 排除Node.js核心模块，这些不需要打包
  external: ['node:fs', 'node:path', 'node:http', 'node:stream', 'node:crypto'],
  // 可选：开启压缩减小文件体积
  minify: false,
});

4. 修改package.json的build脚本，让Astro构建完成后自动执行打包：

"scripts": {
  "build": "astro build && node bundle-server.js"
}

5. 执行npm run build后，dist/server下会生成bundled-entry.mjs文件，这个文件包含了所有第三方依赖，直接运行它即可，无需依赖项目根目录的node_modules。

方案二：自定义Astro插件实现构建时打包（进阶） #

如果你想在Astro构建流程中直接完成打包，可以自定义一个Astro插件，在构建完成后触发esbuild打包逻辑：

1. 在项目根目录创建plugins/bundle-server.mjs：

import { build } from 'esbuild';

export default function bundleServerPlugin() {
  return {
    name: 'bundle-server',
    hooks: {
      'astro:build:done': async () => {
        await build({
          entryPoints: ['./dist/server/entry.mjs'],
          outfile: './dist/server/bundled-entry.mjs',
          platform: 'node',
          bundle: true,
          format: 'esm',
          external: ['node:*'],
        });
      },
    },
  };
}

2. 在astro.config.mjs中引入并使用这个插件：

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
import bundleServerPlugin from './plugins/bundle-server.mjs';

export default defineConfig({
  output: "server",
  adapter: node({
    mode: "standalone"
  }),
  plugins: [bundleServerPlugin()],
});

3. 执行npm run build后，同样会生成可独立运行的bundled-entry.mjs。

注意事项 #

• 对于包含原生代码的依赖（比如需要node-gyp编译的模块），esbuild无法将其打包进文件，需要将这类依赖添加到external配置中，并手动将对应的文件拷贝到dist/server目录下。
• 如果项目中存在动态导入的依赖，需要确保esbuild能识别到这些模块，或者手动在entryPoints中添加相关文件。

内容的提问来源于stack exchange，提问作者Felix Eklöf