Strapi中无法通过locale参数获取同ID多语言集合类型，求解决方案

数据老陈

2026-7-20

Strapi集合类型多语言查询locale参数无效的解决办法

Strapi里集合类型和单类型的多语言机制存在差异：单类型的多语言版本共享同一个ID，而集合类型的每个语言版本会生成独立的数据库ID，这就是你用同一ID加locale参数无法获取对应语言内容的核心原因。

以下是几个可行的解决办法：

1. 用唯一标识字段配合filters查询

如果你的集合类型有全局唯一的字段（比如slug、unique_code这类在所有语言版本中保持一致的字段），可以通过filters替代ID查询，再加上locale参数指定语言：

https://myapp.url/api/industry-pages?filters[slug][$eq]=manufacturing-industry&locale=fi&populate=deep

这种方式无需修改代码，直接通过API参数就能实现需求。

2. 自定义控制器修改findOne逻辑

通过修改集合类型的控制器，让findOne接口支持按原始ID+locale查询对应语言版本：

找到对应集合类型的控制器文件，路径一般为./src/api/industry-page/controllers/industry-page.js
替换findOne方法为以下代码：

module.exports = {
  async findOne(ctx) {
    const { id } = ctx.params;
    const { locale, populate } = ctx.query;

    // 查询对应ID的条目并匹配指定locale
    const entry = await strapi.db.query('api::industry-page.industry-page').findOne({
      where: {
        id,
        locale,
      },
      populate: populate,
    });

    if (!entry) {
      return ctx.notFound('该语言版本的条目不存在');
    }

    return entry;
  },
};

修改后重启Strapi，就能用你原本期望的请求格式https://myapp.url/api/industry-pages/1?locale=fi&populate=deep获取对应语言内容。