如何在Node.js/Express多文件中访问PrismaClient实例？

直接在index.ts里导出PrismaClient实例会导致导入路径混乱，而且不符合模块化最佳实践。正确的做法是单独创建一个Prisma实例文件，在所有需要的地方统一导入，既保证全局只有一个实例，又能让代码结构更清晰。

步骤1：创建独立的Prisma实例文件 #

在项目根目录新建prisma/client.ts，专门存放PrismaClient实例：

import { PrismaClient } from '@prisma/client';

// 创建全局唯一的PrismaClient实例
const prisma = new PrismaClient({
  // 可选：添加日志配置方便调试
  log: ['query', 'info', 'warn'],
});

export default prisma;

步骤2：修改index.ts，移除内部的Prisma实例创建 #

把原来在index.ts里的PrismaClient创建代码删掉，改成导入上面的共享实例：

import express from "express";
import userRoutes from "./routes/users";
// 导入共享的Prisma实例
import prisma from './prisma/client';

const app = express();

app.get("/", (req, res) => {
    res.send("helloBAA")
})

// 解析JSON请求体（之前的代码漏了这个，否则无法接收req.body）
app.use(express.json());

app.use('/api/users', userRoutes)

app.listen(3500, () => {
    console.log("listening on port 3500")
})

注意：新增app.use(express.json())，否则req.body会是undefined，创建用户时拿不到参数。

步骤3：在controllers/users.ts中正确导入Prisma实例 #

修改控制器文件，导入共享的Prisma实例并使用：

import { RequestHandler } from 'express';
// 注意路径：从controllers文件夹到prisma/client.ts的相对路径
import prisma from '../prisma/client';
import dotenv from "dotenv"
import axios from 'axios';

// 加载环境变量
dotenv.config();

export const createUser:RequestHandler = async (req, res, next) => {
  try {
    const newUser = await prisma.user.create({
      data: {
        username: req.body.username,
        email: req.body.email,
        password: req.body.password // 重要提示：实际项目必须对密码加密，比如用bcrypt
      }
    });
    res.status(201).json(newUser);
  } catch (error) {
    // 把错误传递给Express的错误处理中间件
    next(error);
  }
}

export const getUsers: RequestHandler = async (req, res, next) => {
  try {
    const users = await prisma.user.findMany();
    res.status(200).json(users);
  } catch (error) {
    next(error);
  }
}

export const getUser: RequestHandler = async (req, res, next) => {
  try {
    const user = await prisma.user.findUnique({
      where: { id: req.params.userId }
    });
    if (!user) {
      return res.status(404).json({ message: "用户不存在" });
    }
    res.status(200).json(user);
  } catch (error) {
    next(error);
  }
}

为什么这么做？ #

• 符合Prisma官方推荐：全局只创建一个PrismaClient实例，避免重复建立数据库连接浪费资源
• 模块化结构更清晰：Prisma相关配置集中管理，index.ts专注于Express应用初始化
• 避免路径错误：单独的实例文件让所有模块的导入路径更直观，不会出现相对路径混乱的问题

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