Strapi v4无法使用Bookshelf查询构建器？迁移技术求助

Strapi v4默认已经移除了对Bookshelf ORM的内置支持，改用Prisma作为默认ORM，所以你原来基于Bookshelf的查询写法会失效，不是配置遗漏的问题。下面给你两种可行的解决方案：

方案一：切换到Prisma查询（推荐） #

这是v4的官方推荐方式，Prisma提供了更直观的查询语法，同样支持复杂的关联查询和字段选择。

对应你原来的示例代码，v4的写法如下：

const result = await strapi.db.query('restaurant').findOne({
  where: { id: 1 },
});

如果需要复杂查询（比如关联查询、指定返回字段），示例如下：

// 查询餐厅及其关联的菜品，只返回指定字段
const restaurantWithDishes = await strapi.db.query('restaurant').findOne({
  where: { id: 1 },
  select: ['name', 'address'], // 指定返回餐厅的字段
  populate: {
    dishes: { // 关联的dishes集合
      select: ['name', 'price'], // 指定菜品的返回字段
      where: { is_available: true } // 对关联数据加筛选条件
    }
  }
});

更复杂的聚合、多条件查询可以直接使用Prisma的原始查询能力：

const result = await strapi.db.connection.restaurant.findMany({
  where: {
    OR: [
      { rating: { gte: 4.5 } },
      { address: { contains: 'Beijing' } }
    ]
  },
  include: {
    dishes: true
  },
  orderBy: { rating: 'desc' }
});

方案二：重新启用Bookshelf（仅用于兼容旧代码） #

如果你的项目依赖大量旧的Bookshelf查询代码，不想全部重写，可以通过安装官方的Bookshelf数据库适配器来恢复支持：

1. 安装Bookshelf适配器和对应的数据库驱动（以PostgreSQL为例）：

npm install @strapi/database-connector-bookshelf pg

2. 修改config/database.js（或config/database.ts）配置，切换到Bookshelf适配器：

module.exports = ({ env }) => ({
  connection: {
    client: 'postgres', // 对应你的数据库类型
    connection: {
      host: env('DATABASE_HOST', 'localhost'),
      port: env.int('DATABASE_PORT', 5432),
      database: env('DATABASE_NAME', 'strapi'),
      user: env('DATABASE_USERNAME', 'strapi'),
      password: env('DATABASE_PASSWORD', 'strapi'),
      ssl: env.bool('DATABASE_SSL', false),
    },
    connector: 'bookshelf', // 指定使用Bookshelf适配器
  },
});

3. 重启Strapi后，你就可以沿用类似v3的Bookshelf查询写法了，示例：

// 简化写法
const result = await strapi.query('restaurant').findOne({
  where: { id: 1 }
});

// 原始Bookshelf查询构建器写法
const restaurantModel = strapi.query('restaurant').model;
const result = await restaurantModel.query(qb => {
  qb.where('id', 1)
    .with('dishes') // 关联查询
    .select('name', 'address'); // 指定字段
}).fetch();

需要注意的是，官方未来会更侧重Prisma的维护，Bookshelf适配器的功能更新可能会滞后，所以长期来看还是建议逐步迁移到Prisma。

内容的提问来源于stack exchange，提问作者Ali Raza Sherazi