如何在Strapi启动时通过代码创建自定义认证角色？

你遇到的「Model role not found」错误是因为Strapi V4重构了后台模块的模型结构，V3版本中strapi-admin命名空间下的role模型，在V4里已改为strapi::role，且查询API也有更新。以下是在bootstrap函数中自动创建自定义角色的可行方案：

核心代码实现 #

将这段代码放在Strapi V4的全局bootstrap函数中（通常是src/index.js，若你的项目结构是在src/api/server.js，也可放在对应位置的bootstrap里）：

module.exports = {
  async bootstrap({ strapi }) {
    // 检查自定义角色是否已存在，避免重复创建
    const targetRole = await strapi.db.query('strapi::role').findOne({
      where: { code: 'custom-authenticated-role' }
    });

    if (!targetRole) {
      // 创建自定义认证角色
      const newRole = await strapi.db.query('strapi::role').create({
        data: {
          name: '自定义认证用户',
          code: 'custom-authenticated-role', // 唯一标识，不可重复
          description: '拥有专属权限的认证用户角色',
          type: 'authenticated' // 标记为认证用户类型，和默认authenticated角色同类别
        }
      });

      // 可选：为角色分配权限（示例：复制默认认证用户的文章查询权限）
      const defaultAuthPermission = await strapi.db.query('strapi::permission').findOne({
        where: {
          action: 'api::article.find',
          role: { code: 'authenticated' }
        }
      });

      if (defaultAuthPermission) {
        await strapi.db.query('strapi::permission').create({
          data: {
            action: defaultAuthPermission.action,
            role: newRole.id,
            properties: defaultAuthPermission.properties,
            conditions: defaultAuthPermission.conditions
          }
        });
      }
    }
  }
};

关键说明 #

• 模型命名变化：V4中后台角色模型的标识是strapi::role，不再使用V3的strapi-admin命名空间
• 查询API更新：使用strapi.db.query()替代旧的strapi.query()，这是V4官方推荐的数据库查询方式
• 角色类型指定：设置type: 'authenticated'可让该角色归类为认证用户角色，和系统默认的认证角色保持一致的权限体系
• 权限分配：若需给自定义角色配置权限，直接操作strapi::permission模型即可，可参考系统默认角色的权限结构来复制或自定义

注意事项 #

• 角色的code字段必须唯一，不能和系统默认角色（authenticated、public、super-admin）重复
• bootstrap函数只会在Strapi启动时执行一次，重启服务后才会重新触发
• 确保数据库连接正常，否则创建角色的操作会失败

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