GitHub服务容器中NextJS无法读取Prisma Adapter属性问题

我参照GitHub PostgreSQL服务容器文档做部署前测试，架构是NextJS应用容器搭配独立PostgreSQL容器，用Prisma作为ORM实现交互。运行工作流时碰到无法读取Prisma Adapter属性的错误，网上相关教程不多，下面给出我的问题排查和修正方案。

现有配置的核心问题 #

• Node版本过低：使用的node:14已停止维护，无法适配新版本的NextJS和Prisma，容易引发兼容性问题
• 缺失Prisma关键步骤：没有生成Prisma客户端、同步数据库结构，导致ORM无法正常工作
• 环境变量不完整：仅配置了HOST和PORT，缺少Prisma必需的DATABASE_URL，以及PostgreSQL的用户名、数据库名等信息
• 服务容器网络配置冗余：容器作业内的服务容器通过内部网络访问，无需端口映射到主机

修正后的完整工作流配置 #

name: NextJS + Prisma PostgreSQL Test
on: push

jobs:
  test-with-postgres:
    runs-on: ubuntu-latest
    # 用适配NextJS和Prisma的Node版本
    container: node:20

    services:
      postgres:
        # 指定具体PostgreSQL版本，避免兼容性风险
        image: postgres:16
        env:
          POSTGRES_USER: postgres
          POSTGRES_PASSWORD: postgres
          # 提前创建测试用数据库
          POSTGRES_DB: test_db
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        # 容器作业内部通过服务名访问，无需端口映射
        # ports:
        #   - 5432:5432

    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 安装依赖
        run: npm ci
        # 用pnpm/yarn的话替换成对应命令：pnpm install --frozen-lockfile / yarn install --frozen-lockfile

      - name: 生成Prisma客户端
        run: npx prisma generate
        # 必须执行此步骤，生成适配当前环境的ORM客户端代码

      - name: 同步数据库结构
        run: npx prisma db push
        # 测试环境用db push快速同步schema，生产环境建议用migrate deploy
        env:
          DATABASE_URL: postgresql://postgres:postgres@postgres:5432/test_db?schema=public

      - name: 运行应用测试
        run: npm run test # 替换成你的实际测试命令，比如next test
        env:
          DATABASE_URL: postgresql://postgres:postgres@postgres:5432/test_db?schema=public
          # 其他NextJS需要的环境变量在此添加

Adapter错误的针对性排查 #

1. 检查Prisma Adapter导入路径
   确保代码中导入的是正确的包，比如用NextAuth的场景：

   import { PrismaAdapter } from "@next-auth/prisma-adapter";
   import { PrismaClient } from "@prisma/client";
   

   避免拼写错误，且对应的依赖包已在package.json中声明并安装。

2. 确认Prisma Client初始化正确
   不要使用未初始化的Prisma实例传入适配器：

   const prisma = new PrismaClient();
   // 正确传入已初始化的实例
   const adapter = PrismaAdapter(prisma);
   

3. 验证数据库连接有效性
   在运行测试前，可以添加一步测试连接的命令：

   - name: 测试数据库连接
     run: npx prisma db execute --query "SELECT 1"
     env:
       DATABASE_URL: postgresql://postgres:postgres@postgres:5432/test_db?schema=public
   

   确保服务容器的PostgreSQL已正常启动并可访问。

内容的提问来源于stack exchange，提问作者Wer Wer