Strapi V4 Query Engine API：如何移除图片formats嵌套冗余字段

问题背景 #

使用Strapi Query Engine API获取产品数据时，图片preview下的formats字段会返回大量冗余信息（如ext、hash、size等），尝试用常规select语法筛选仅保留url无效，原因是formats及其子字段（如xsmall）是Strapi自动生成的动态媒体字段，不属于数据库模型定义的实体字段，无法通过Query Engine的原生筛选规则直接控制。

可行解决方案 #

方案1：通过生命周期钩子自动处理数据

在产品内容类型的生命周期钩子中，拦截查询结果并过滤冗余字段，无需修改业务查询代码。

在api/product/content-types/product/lifecycle.js文件中添加以下代码：

module.exports = {
  async afterFind(event) {
    const { result } = event;
    // 定义单条数据的处理逻辑
    const filterFormatUrl = (item) => {
      if (item.preview?.formats) {
        Object.keys(item.preview.formats).forEach(formatKey => {
          item.preview.formats[formatKey] = {
            url: item.preview.formats[formatKey].url
          };
        });
      }
      return item;
    };

    // 兼容单条/多条数据返回的情况
    event.result = Array.isArray(result) 
      ? result.map(filterFormatUrl) 
      : filterFormatUrl(result);
  },
};

方案2：查询后手动处理返回结果

如果不想修改钩子，可在查询完成后直接对返回数据做过滤处理：

// 先完整获取包含formats的所有数据
const products = await strapi.db.query("api::product.product").findMany({
  populate: {
    preview: {
      populate: "formats"
    }
  }
});

// 过滤仅保留url字段
const processedProducts = products.map(product => {
  if (product.preview?.formats) {
    const filteredFormats = {};
    Object.entries(product.preview.formats).forEach(([key, format]) => {
      filteredFormats[key] = { url: format.url };
    });
    product.preview.formats = filteredFormats;
  }
  return product;
});

方案3：改用GraphQL API（可选）

如果项目支持GraphQL，可以通过精准的字段选择直接获取所需内容：

query GetProducts {
  products {
    product_name
    preview {
      formats {
        xsmall {
          url
        }
      }
    }
  }
}

内容的提问来源于stack exchange，提问作者Денис Беспалов