這篇文章也可以在我的部落格上找到：https://hamidreza.tech/nestjs-on-vercel。

如果您使用 Express 轉(zhuǎn)接器，本指南會(huì)很有幫助。對(duì)於使用 Fastify 適配器的 NestJS 應(yīng)用程序，這些連結(jié)可能會(huì)有所幫助：

• https://fastify.dev/docs/latest/Guides/Serverless/#vercel

• https://github.com/vercel/examples/tree/main/starter/fastify

？您可以在此 GitHub 儲(chǔ)存庫(kù)中存取本文中討論的完整原始程式碼：https://github.com/mahdavipanah/nestjs-on-vercel

Vercel 對(duì) Express 應(yīng)用程式的支持

Vercel 提供了一項(xiàng)便捷的功能，用於透過(guò)以下方式部署 Express 應(yīng)用程式：

1. 在 API 中公開(kāi) Express 應(yīng)用程式物件。

2. 定義一個(gè)重寫(xiě)規(guī)則，將所有傳入流量導(dǎo)向此單一 API。

我依照 Vercel 的官方 Express 部署指南部署 NestJS，方法類似地公開(kāi) NestJS 的底層 Express 應(yīng)用程式物件。

第 1 步 - 建立一個(gè) NestJS 應(yīng)用程式

如果您已經(jīng)設(shè)定了 NestJS 應(yīng)用，請(qǐng)?zhí)^(guò)此步驟。

安裝 NestJS 並建立一個(gè)新應(yīng)用程式：

nest new my-app

第 2 步 - 安裝必要的 NPM 軟體包

npm install express @nestjs/platform-express
npm install -D @types/express

步驟 3 - 建立 src/AppFactory.ts 文件

此檔案用作管理所有必要的 NestJS 應(yīng)用程式引導(dǎo)的單一模組，並匯出 NestJS 應(yīng)用程式及其底層 Express 應(yīng)用程式物件。

在專案根目錄的 src 目錄中建立一個(gè)名為 AppFactory.ts 的檔案：

import { ExpressAdapter } from '@nestjs/platform-express';
import { NestFactory } from '@nestjs/core';
import express, { Request, Response } from 'express';
import { Express } from 'express';
import { INestApplication } from '@nestjs/common';
import { AppModule } from './app.module.js';

export class AppFactory {
  static create(): {
    appPromise: Promise<INestApplication<any>>;
    expressApp: Express;
  } {
    const expressApp = express();
    const adapter = new ExpressAdapter(expressApp);
    const appPromise = NestFactory.create(AppModule, adapter);

    appPromise
      .then((app) => {
        // You can add all required app configurations here

        /**
         * Enable cross-origin resource sharing (CORS) to allow resources to be requested from another domain.
         * @see {@link https://docs.nestjs.com/security/cors}
         */
        app.enableCors({
          exposedHeaders: '*',
        });

        app.init();
      })
      .catch((err) => {
        throw err;
      });

    // IMPORTANT This express application-level middleware makes sure the NestJS app is fully initialized
    expressApp.use((req: Request, res: Response, next) => {
      appPromise
        .then(async (app) => {
          await app.init();
          next();
        })
        .catch((err) => next(err));
    });

    return { appPromise, expressApp };
  }
}

第 4 步 - 修改 src/main.ts 文件

預(yù)設(shè)情況下，NestJS 有一個(gè) src/main.ts 檔案作為應(yīng)用程式的入口點(diǎn)，包括所有配置和引導(dǎo)。修改此檔案以將所有內(nèi)容移至 AppFactory.ts 檔案中，僅保留監(jiān)聽(tīng)方法的呼叫：

import { AppFactory } from './AppFactory.js';

async function bootstrap() {
  const { appPromise } = AppFactory.create();
  const app = await appPromise;

  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

第 5 步 - 新增 api/index.ts 文件

預(yù)設(shè)情況下，Vercel 執(zhí)行階段會(huì)建置專案的 /api 目錄中建立的任何函數(shù)並將其提供給 Vercel (doc)。由於 Vercel 理解並處理 Express 應(yīng)用程式對(duì)象，因此在此目錄中建立一個(gè)導(dǎo)出 Express 應(yīng)用程式物件的函數(shù)：

/**
 * This file exports Express instance for specifically for the deployment of the app on Vercel.
 */

import { AppFactory } from '../src/AppFactory.js';

export default AppFactory.create().expressApp;

第 6 步 - 新增 vercel.json 文件

在專案根目錄下建立一個(gè)名為 vercel.json 的檔案來(lái)設(shè)定 Vercel。在這裡，為 Vercel 定義一個(gè)重寫(xiě)規(guī)則，以使用 Express 應(yīng)用程式來(lái)服務(wù)所有傳入流量 (doc)。

您也可以使用 api 目錄中的 tsconfig.json 檔案來(lái)設(shè)定 Vercel 的 TypeScript 編譯器。除了 「路徑映射」 和 「Pr物件參考s」 之外，大多數(shù)選項(xiàng)均受支援。

nest new my-app

第 7 步 - 在 Vercel 上建立項(xiàng)目

恭喜？ ！我們快完成了?，F(xiàn)在，建立一個(gè) git 儲(chǔ)存庫(kù)並將原始程式碼推送到其中。然後，前往您的 Vercel 帳戶，建立一個(gè)新項(xiàng)目，並匯入 git 儲(chǔ)存庫(kù)。您也可以使用本文的範(fàn)例 GitHub 儲(chǔ)存庫(kù)。

以上是Vercel 上快速、簡(jiǎn)單的 NestJS 應(yīng)用程式部署的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！