Strapi中新增组件未显示在现有组件列表的问题咨询

问题原因 #

• 组件分类不匹配：Strapi的组件是按分类（Category）分组的，如果你创建hero_type_1时选择的分类和父组件当前选中的分类不一致，就不会在选择框里显示。
• 后台缓存未更新：Strapi后台界面的组件列表可能缓存了旧数据，没有实时加载新创建的组件。
• 组件保存异常：创建hero_type_1时可能存在表单验证未通过但无提示的情况，导致组件没有被系统正确注册。
• 项目文件未同步：如果是多人协作或使用版本控制，本地的组件JSON文件可能未同步，或者Strapi没有重新读取组件定义。

无需手动修改JSON的解决方法 #

• 匹配组件分类
  进入组件管理页面，确认hero_type_1所属的分类，然后在父组件添加属性时，切换到对应的分类标签即可看到该组件。如果需要跨分类调用，选择All分类标签就能显示所有组件。

• 刷新后台并重启服务

  1. 先强制刷新浏览器页面（快捷键Ctrl+Shift+R或Cmd+Shift+R），清空页面缓存后查看组件是否出现。
  2. 若刷新无效，停止Strapi服务（终端按Ctrl+C），再执行npm run develop（或yarn develop）重启服务，让Strapi重新加载所有组件定义。

• 重新确认组件状态
  回到组件管理界面，找到hero_type_1进入编辑页，检查所有字段是否填写完整，重新点击保存按钮，确保组件被系统正确存储。

• 清理Strapi缓存
  停止服务后，删除项目根目录下的.cache和build文件夹，再重新启动服务。这会强制Strapi重新生成组件缓存和构建文件，解决缓存导致的加载异常。

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