CodeIgniter 白屏本质是错误被静默屏蔽，修复关键是先启用错误显示：在 index.php 首行加 error_reporting(E_ALL); ini_set('display_errors', '1'); 并检查 Apache/Nginx 错误日志和 application/logs/ 日志。
CodeIgniter 白屏（500 或纯空白）基本不是框架“坏了”，而是错误被静默吞掉或输出被提前中断。最有效的修复路径是：先让错误显形，再定位源头。
怎么让白屏变报错信息
CodeIgniter 默认不显示 PHP 错误，尤其在生产环境。必须手动打开错误报告开关：
- 打开
index.php（项目根目录入口文件），在第一行 PHP 标签后立即插入：error_reporting(E_ALL);<br>ini_set('display_errors', '1');<br>ini_set('display_startup_errors', '1'); - 如果用 Apache，可在
.htaccess加：php_flag display_errors on；Nginx 则需确认 PHP-FPM 配置里有php_admin_flag[display_errors] = on - 别只信浏览器页面——同时检查 Apache/Nginx 的错误日志（如
/var/log/apache2/error.log）和 CodeIgniter 自己的日志（application/logs/下最新log-*.php文件）
autoload 加载 database 导致白屏的典型原因
在 application/config/autoload.php 里把 'database' 加进 $autoload['libraries']，看似省事，实则高危。CI 2.1.0 及部分旧版本中，这个操作会触发 db_set_charset() 函数里的兼容性判断逻辑失败，尤其当 mysql_set_charset() 不可用但又没 fallback 到 SET NAMES 时，直接 fatal error。
- 现象：页面全白，Apache 日志里可能只有
PHP Fatal error: Call to undefined function mysql_set_charset()或完全没记录 - 临时解法：注释掉 autoload.php 中的
'database'，改在控制器里按需加载：$this->load->database(); - 根本解法：升级到 CI 3.x+（已弃用 mysql_* 函数），或确保 PHP 版本 ≥ 5.2.3、MySQL ≥ 5.0.7，并确认
mysql扩展已启用（虽然不推荐）
视图文件加载失败却没提示
$this->load->view('posts/index') 这类调用失败时，CI 默认不报错，只是跳过——结果就是页面结构断裂、部分内容消失，看起来像“白屏”。
- 检查点：文件路径大小写是否严格匹配（
Posts/index.php≠posts/index.php）、后缀是否多加了.php（应写posts/index，不是posts/index.php） - 权限问题：确认 Web 用户（如
www-data）对application/views/下文件有读权限（chmod 644起步） - 调试技巧：在疑似出问题的视图文件开头加
<?php die('loaded'); ?>，没输出就说明根本没加载进来，问题在路径或控制器传参环节 - 动态视图名务必校验：
if (!empty($view_name) && file_exists(APPPATH . 'views/' . $view_name . '.php')) { $this->load->view($view_name); }
BOM 头、空格、session_path 配置引发的静默中断
UTF-8 BOM（\xEF\xBB\xBF）或 PHP 文件开头/结尾的多余空格，会导致 HTTP headers 已发送警告，进而阻断 CI 的输出缓冲机制，页面直接空白。
- 用 VS Code 开启 “Show All Characters”，检查
index.php、所有 config 文件、以及application/views/下视图文件——<?php前不能有任何字符，包括空格、换行、BOM - Linux/macOS 下快速扫描 BOM：
grep -rl $'\xEF\xBB\xBF' .，找到后用编辑器另存为 UTF-8 without BOM - Nginx + PHP-FPM 环境下，若
session.save_path不可写（比如设成了/tmp但权限不对），也会导致白屏且无明确错误；检查php.ini中session.save_path是否有效，或临时改为绝对可写路径并chown www-data:www-data /path/to/session/dir
真正卡住人的往往不是报错本身，而是错误没出来——所以修白屏的第一步永远不是猜哪行代码错了，而是确保错误能打到你眼前。一旦看到真实报错，90% 的问题就解决了一半。
