CodeIgniter HMVC路由线上模块控制器失效，默认控制器正常求助

这种线上线下不一致的问题真的很闹心，我帮你整理了几个最常见的排查方向，按顺序试下来大概率能解决：

线上服务器经常会在URL重写这里掉链子，毕竟本地环境一般都默认配置好了：

• 首先检查Apache是否启用了mod_rewrite模块：可以通过生成phpinfo()页面查看，或者直接联系主机服务商确认。
• 核对项目根目录的.htaccess文件内容，确保是CodeIgniter HMVC适用的配置，比如：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

• 还要确认服务器允许.htaccess生效，也就是Apache配置里的AllowOverride All选项是否开启。如果是虚拟主机，通常可以在主机控制面板里找到这个设置项。

本地Windows系统是大小写不敏感的，但线上Linux服务器对大小写要求严格，这是很多人踩坑的点：

• 确保模块的目录名、控制器文件名、类名的大小写完全匹配。比如模块目录是Blog，控制器文件就得是Blog.php，类名也得是class Blog extends MX_Controller，不能写成小写的blog或者乱改后缀。
• 检查路由规则里的模块名称大小写，比如$route['blog/list'] = 'blog/Article/list';要和实际模块目录名的大小写完全一致。

• 确认你的HMVC扩展（比如常用的MX框架）在服务器上的文件是完整的，有没有漏掉application/third_party/MX目录下的文件，传输过程中可能会丢文件。
• 检查模块内部的路由配置（比如modules/your_module/config/routes.php）有没有语法错误，线上服务器的错误提示可能更严格，一些本地忽略的小错误（比如少个分号）会直接导致路由失效。
• 尝试用完整路径访问模块控制器，比如http://yourdomain.com/index.php/your_module/your_controller，如果能访问，说明是自定义路由规则的问题；如果还是404，那就是模块本身的加载问题。

• 本地和线上的PHP版本可能不一样，有些旧版HMVC扩展对PHP 8.x兼容性不好，会导致控制器无法加载。可以通过phpinfo()查看两边的PHP版本，必要时升级或降级HMVC适配版本。
• 开启线上服务器的错误提示，直接看具体报错：在项目根目录的index.php里添加error_reporting(E_ALL); ini_set('display_errors', 1);，调试完记得关掉，避免泄露信息。服务器的错误日志里也可能藏着关键线索，比如“找不到类XXX”之类的提示。

线上服务器的文件权限设置不对，会导致PHP读不到模块文件：

• 把模块目录的权限设为755，文件权限设为644，这是PHP项目的通用安全权限配置。
• 确认服务器的运行用户（比如www-data）对模块目录有读取权限，有些主机商的权限配置比较严格，需要手动调整。

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