Namecheap共享主机部署Codeigniter4提交特定表单报403错误求助

故障原因定位与解决方案 #

1 核心高频原因：CSRF令牌校验失败 #

CodeIgniter4默认开启CSRF跨站请求伪造防护，令牌会和域名绑定。你更换到新子域名new.domain.com后未更新CSRF配置，表单提交时令牌校验不通过，就会直接返回403错误。
解决方案：

• 打开app/Config/Security.php配置文件，修改$cookieDomain参数为.domain.com，适配根域名下所有子域名
• 确认课程提交表单是用CI4提供的form_open()辅助函数生成，会自动插入CSRF隐藏字段；如果是手写form标签，需要在表单内手动添加<?= csrf_field() ?>
• 如果该表单是AJAX提交，需要在请求头中携带X-CSRF-TOKEN参数，值为Cookie中存储的CSRF令牌值

2 允许域名列表未配置 #

CodeIgniter4自带主机头攻击防护，未加入允许列表的域名访问会返回403错误。
解决方案：
打开app/Config/App.php配置文件，找到$allowedHosts参数，将new.domain.com加入允许列表，示例：

public $allowedHosts = ['localhost', '你的A域名', 'new.domain.com'];

3 Apache mod_security WAF规则拦截 #

你当前的表单包含文件上传+大量文本内容，很可能触发服务器端mod_security安全模块的拦截规则返回403。
解决方案：
临时在站点根目录的.htaccess文件中添加以下规则测试是否恢复正常：

<IfModule mod_security.c>
SecRuleEngine Off
</IfModule>

如果测试后提交正常，不要长期关闭mod_security，联系服务器运维调整对应拦截规则即可。

4 重写规则兼容问题 #

你当前的.htaccess重写规则在部分不支持PATH_INFO的服务器环境下会导致带复杂参数的POST请求解析失败，返回403。
解决方案：
将原重写规则：

RewriteRule ^(.*)$ index.php/$1 [L]

修改为CodeIgniter4官方推荐的写法：

RewriteRule ^(.*)$ index.php?/$1 [L]

5 附带代码问题修正（不会直接导致403，但会导致功能异常） #

你当前的文件上传验证规则写法错误：验证数组的键需要和表单上传字段名一致，你写的file对应规则却是校验image字段，会导致上传正常也触发验证失败，默认使用default.jpg。
修改方案：
将验证规则调整为：

$validated = $this->validate([
    'image' => [
        'uploaded[image]',
        'mime_in[image,image/jpg,image/jpeg,image/gif,image/png]',
        'max_size[image,4096]',
    ],
]);

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