Strapi v4生产环境中为places集合批量生成slug（UID类型）

针对你现有200条Places数据无法自动生成Slug的问题，下面提供三种无需手动逐条操作的解决方案，按推荐程度排序：

方法一：使用Strapi内置脚本（最安全，贴合Strapi原生逻辑） #

Strapi允许通过自定义脚本直接调用内部服务，能保证Slug生成逻辑和后台创建时完全一致：

1. 在项目根目录新建scripts/update-places-slugs.js文件，内容如下：

const strapi = require('@strapi/strapi');

async function updateSlugs() {
  // 初始化Strapi实例
  const app = await strapi().load();

  try {
    // 查询所有未设置slug的Places记录（需覆盖全部则删除where条件）
    const places = await app.db.query('api::place.place').findMany({
      where: { slug: null },
      select: ['id', 'title']
    });

    console.log(`找到 ${places.length} 条需要更新的记录`);

    for (const place of places) {
      // 调用Strapi内置UID生成器，和后台创建逻辑完全对齐
      const generatedSlug = await app.service('plugin::content-manager.uid').generateUIDField({
        contentTypeUID: 'api::place.place',
        field: 'slug',
        data: { title: place.title }
      });

      // 更新记录
      await app.db.query('api::place.place').update({
        where: { id: place.id },
        data: { slug: generatedSlug }
      });

      console.log(`已更新ID ${place.id} 的slug: ${generatedSlug}`);
    }

    console.log('Slug批量更新完成');
  } catch (error) {
    console.error('更新失败:', error);
    process.exit(1);
  } finally {
    await app.destroy();
  }
}

updateSlugs();

2. 在项目根目录执行脚本：

node scripts/update-places-slugs.js

注意：执行前请停止Strapi服务，或先在测试环境验证逻辑；生产环境操作前务必备份数据库。

方法二：直接操作PostgreSQL数据库（最快，适合熟悉SQL的场景） #

如果确认Slug生成规则是基于title的小写连字符格式，可以直接通过SQL批量更新，无需启动Strapi：

1. 连接到你的PostgreSQL生产数据库
2. 执行以下SQL语句（Strapi v4默认表名为api_places_place，有自定义前缀需调整）：

UPDATE api_places_place
SET slug = lower(regexp_replace(title, '[^a-zA-Z0-9]+', '-', 'g'))
WHERE slug IS NULL; -- 仅更新未设置的记录，需覆盖全部则删除WHERE条件

注意：执行前必须备份数据库！如果你的Slug需要自动去重（比如重复标题生成my-place-2），这条SQL无法处理，建议用方法一。

方法三：通过Strapi API批量更新（无需停服，适合生产环境在线操作） #

如果生产环境无法停止Strapi服务，可以写一个简单的Node脚本调用API批量更新：

1. 新建scripts/batch-update-slugs-api.js文件：

const axios = require('axios');
const { slugify } = require('@strapi/utils');

// 配置Strapi API信息
const STRAPI_URL = 'https://your-strapi-domain.com';
const API_TOKEN = 'your-admin-api-token'; // 在Strapi后台生成管理员API令牌

async function updateSlugsViaAPI() {
  try {
    // 获取所有Places记录（pageSize设为1000确保一次性拉取全量）
    const { data: places } = await axios.get(`${STRAPI_URL}/api/places?pagination[pageSize]=1000`, {
      headers: { Authorization: `Bearer ${API_TOKEN}` }
    });

    const records = places.data;
    console.log(`获取到 ${records.length} 条记录`);

    for (const place of records) {
      if (!place.attributes.slug) {
        // 用Strapi内置的slugify方法生成slug
        const newSlug = slugify(place.attributes.title);
        // 调用API更新记录
        await axios.put(`${STRAPI_URL}/api/places/${place.id}`, {
          data: { slug: newSlug }
        }, {
          headers: { Authorization: `Bearer ${API_TOKEN}` }
        });
        console.log(`已更新ID ${place.id} 的slug: ${newSlug}`);
      }
    }

    console.log('API批量更新完成');
  } catch (error) {
    console.error('API更新失败:', error.response?.data || error.message);
  }
}

updateSlugsViaAPI();

2. 安装依赖并执行：

npm install axios @strapi/utils
node scripts/batch-update-slugs-api.js

注意：如果存在重复slug，Strapi后台会自动添加后缀去重，但API调用方式需要额外处理重复场景，建议先在测试环境验证。

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