我之前在Strapi开发时也碰到过类似的路由匹配问题，结合你的情况，帮你梳理几个最可能的原因和对应的解决办法：

1. 路由匹配优先级冲突（最常见原因） #

Strapi的路由是按注册顺序进行匹配的，如果你启用了material类型的默认REST路由（自动生成的CRUD接口），那么默认的GET /materials/:id路由会优先匹配/materials/stock——Strapi会把stock识别为id参数，尝试查找ID为stock的物料，找不到就返回404。

解决办法： #

把你的自定义路由放在默认路由之前，确保精确匹配优先。修改routes.json为：

[
  { 
    "method": "GET", 
    "path": "/materials/stock", 
    "handler": "material.stock", 
    "config": { "policies": [] } 
  },
  // 保留默认的CRUD路由（如果需要的话）
  ...strapi.config.routes['content-api'].material
]

这样Strapi会先匹配你的自定义/materials/stock，再处理默认的动态参数路由。

2. 路由/控制器文件路径或命名错误 #

Strapi对API文件的目录结构和命名有严格要求，哪怕一点小错误都会导致路由无法注册：

• 控制器必须放在src/api/material/controllers/material.js（文件名要和API名称一致，小写）
• 路由文件必须放在src/api/material/config/routes.json

如果你的文件位置不对，比如控制器叫stock.js或者放在了其他目录，Strapi根本找不到对应的material.stock处理器，自然返回404。

3. Docker容器未正确重启，路由缓存未更新 #

用Docker运行Strapi时，有时候修改本地文件后，容器没有实时感知到（特别是开发环境下如果没配置热重载），导致旧的路由配置还在生效。

解决办法： #

直接重启容器强制加载新配置：

docker restart <你的Strapi容器名称/ID>

如果是开发模式，也可以检查一下Docker挂载的volume是否正确，确保本地修改能同步到容器内。

4. 检查Strapi启动日志，确认路由是否注册成功 #

启动容器时，Strapi会输出所有已注册的路由信息。你可以搜索日志里的/materials/stock，看看有没有GET方法的路由被记录：

• 如果日志里完全没有这条路由，说明路由文件没被加载，回到第2点检查路径和命名
• 如果日志里有这条路由但还是404，再检查权限配置是否真的给GET方法开了权限（有时候会不小心只勾选了POST的权限）

5. 权限配置的细节验证 #

再仔细核对角色权限：

1. 进入Strapi后台的「设置」→「角色与权限」
2. 找到你使用的认证角色（比如Authenticated）
3. 展开material的权限列表，确认stock动作的GET方法已经被勾选，并且保存了配置

按照上面的步骤排查，基本就能解决GET端点404的问题了。

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