Strapi自定义插件API访问返回404问题排查求助

以下是针对http://localhost:1337/test返回404的排查步骤及解决方法：

• 检查路由文件结构
  Strapi插件的路由必须放在src/plugins/test/server/routes/index.ts（或.js）文件中。如果路由文件仅放在routes目录下但未命名为index，Strapi无法自动加载该路由配置。

• 确认插件已在配置中启用
  打开项目根目录的config/plugins.ts（或.js），确保已添加test插件的启用配置：

  export default {
    // 其他插件配置...
    test: {
      enabled: true,
      resolve: './src/plugins/test', // 确保路径与你的插件目录一致
    },
  };
  

  Strapi v4要求所有自定义插件必须在此配置文件中注册，否则不会被加载。

• 验证控制器与服务的命名匹配
  虽然你的代码命名规则正确（my-controller.ts对应myController，my-service.ts对应myService），但需确保：

  • 控制器文件放在src/plugins/test/server/controllers目录下
  • 服务文件放在src/plugins/test/server/services目录下
  • 两者的默认导出格式正确，无语法错误

• 重启Strapi服务
  修改插件代码（路由、控制器、服务）后，热重载可能无法识别变更，必须完全重启Strapi服务才能让新配置生效。

• 检查启动日志中的路由注册情况
  启动Strapi时查看控制台日志，搜索包含test的路由条目。如果未看到GET /test相关的注册信息，说明路由未被正确加载，需回到前面的步骤排查文件结构或配置问题。

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