Strapi v4.9.0自定义插件无法显示在管理面板侧边栏求助

• 检查插件权限配置
  进入后台的Settings > Roles & Permissions，针对所用角色（比如管理员、Authenticated），确认你的插件权限已启用。特别是插件的access权限，必须勾选才能在侧边栏显示——自定义插件不会自动给管理员开放权限，需手动配置。

• 验证Admin入口配置
  检查插件根目录admin/src/index.ts文件，确保正确注册了侧边栏或设置页面：

  • 侧边栏入口示例：

    export default {
      register(app) {
        app.addMenuLink({
          to: '/plugins/your-plugin-name',
          icon: 'plug',
          intlLabel: {
            id: 'your-plugin-name.menu.label',
            defaultMessage: 'CSV导出工具',
          },
          Component: lazy(() => import('./pages/Home')),
        });
      },
    };
    

  • 设置页面入口示例：

    export default {
      register(app) {
        app.addSettingsLink({
          id: 'your-plugin-name-settings',
          to: '/settings/your-plugin-name',
          intlLabel: {
            id: 'your-plugin-name.settings.label',
            defaultMessage: 'CSV导出设置',
          },
        });
      },
    };
    

  同时确认admin/src/pages下的组件正确导出，无语法错误。

• 排查TypeScript编译问题

  • 执行插件目录下的npm run build，查看是否有编译错误（类型不匹配、语法错误都会导致Admin面板无法加载插件）。
  • 确保插件tsconfig.json配置正确，编译产物输出到admin/dist目录。
  • 项目根目录执行strapi build时，确认插件Admin部分被正确编译。

• 核对插件注册细节
  检查项目config/plugins.ts，确保插件名称与目录名完全一致（大小写敏感），路径指向正确：

  export default {
    'your-plugin-name': {
      enabled: true,
      resolve: './src/plugins/your-plugin-name',
    },
  };
  

• 彻底清理缓存与重建
  按以下步骤操作，避免缓存残留：

  • 删除项目根目录的.cache、build文件夹
  • 删除插件目录的node_modules、.cache、dist文件夹
  • 依次执行项目根目录npm install、插件目录npm install
  • 执行strapi build --clean强制重建

• 查看日志与控制台报错

  • 启动Strapi时观察终端日志，是否有插件加载失败的提示（如模块缺失、路径错误）。
  • 打开浏览器开发者工具，查看Console面板是否有JS报错（如组件加载失败、资源404）。

• 确认版本兼容性
  检查插件代码中使用的Strapi Admin API是否与v4.9.0兼容，比如addMenuLink的参数格式是否符合该版本要求。

内容的提问来源于stack exchange，提问作者Antonio Palumbo