Codeigniter 4 REST API POST路由无法正常工作求助

针对你遇到的POST请求找不到对应控制器方法、重定向到默认页的问题，按以下步骤排查：

1. 关闭或正确处理CSRF保护（最常见原因） #

CodeIgniter 4默认对POST请求启用CSRF验证，未携带令牌会被拦截并重定向。

• 测试环境临时关闭：编辑app/Config/Filters.php，修改$globals数组，注释掉csrf：

  public $globals = [
      'before' => [
          // 'csrf', // 注释此行临时关闭CSRF验证
      ],
      'after' => [
          'toolbar',
          'honeypot',
      ],
  ];
  

• 生产环境正确处理：先通过GET请求获取CSRF令牌（比如访问项目首页，查看页面源码中的csrf_token字段），然后在POSTMAN的请求头里添加：

  X-CSRF-TOKEN: 你的令牌值
  

2. 验证URL路径与项目根目录配置 #

如果你的项目Web根目录是public文件夹，请求URL应该是：
http://localhost/project/public/api/users/create
很多人直接访问项目根目录，导致路由无法匹配——因为CI4的入口文件在public/index.php，必须通过该目录访问接口。

3. 检查控制器文件与命名空间 #

• 确保UserRegister.php文件存在于app/Controllers/目录下，文件名大小写与类名完全一致（Linux系统严格区分大小写）。
• 控制器类的命名空间必须是namespace App\Controllers;，且继承的BaseController存在于app/Controllers/BaseController.php。

4. 开启调试模式查看具体错误 #

编辑app/Config/App.php，设置：

public $appDebug = true;

开启后POST请求失败时会显示具体错误信息（比如控制器不存在、方法不存在、语法错误等），而非直接重定向，便于精准排查。

5. 验证路由注册正确性 #

临时开启自动路由测试：
在Routes.php里设置$routes->setAutoRoute(true);，尝试访问POST http://localhost/project/public/userregister/register，如果能正常访问，说明手动路由注册存在拼写或路径匹配问题，检查$routes->post('api/users/create', 'UserRegister::register');的路径是否与请求URL完全对应。

额外提示 #

你的控制器代码里存在未使用的use声明（比如CodeIgniter\RESTful\ResourceController、CodeIgniter\HTTP\RequestInterface），可以删除以避免混淆，但不会影响功能运行。

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