CodeIgniter页面渲染空白怎么排查-php教程-PHP中文网

页面渲染空白的首要原因是PHP执行中断或HTML未被正确解析。需检查Network面板的状态码与Content-Type，确认ENVIRONMENT为development以显示错误，验证控制器是否执行到view()，排查视图文件路径、变量名及HTML结构错误。

codeigniter页面渲染空白怎么排查

页面渲染空白，大概率不是视图没写对，而是 HTML 根本没被浏览器当成 HTML 解析，或 PHP 在输出前就中断了。

检查 Network 面板里 HTML 响应状态和 Content-Type

打开浏览器开发者工具（F12），切到 Network 面板，刷新页面，找你访问的 URL（比如 /register-bill 或 /index.php/welcome）：

如果状态码是 404 或 403，说明请求根本没落到 CodeIgniter，检查 .htaccess 是否生效、Apache/Nginx 是否开启重写模块、URL 路径是否带错大小写或多余斜杠
如果状态码是 200 但响应头里 Content-Type 不是 text/html（比如成了 text/plain 或空），浏览器会把 HTML 当纯文本显示——右键“查看页面源代码”能看到标签，但页面就是白的；此时需在控制器里显式设置：$this->response->setContentType('text/html');
如果响应体为空（Preview/Response 面板一片空白），说明 PHP 执行提前终止，没走到 view() 这一步

确认 ENVIRONMENT 是 development 且错误显示已开

CodeIgniter 默认在 production 环境下屏蔽所有错误输出，白屏时什么提示都没有。打开项目根目录下的 index.php，找到类似这行：

define('ENVIRONMENT', 'production');

改成：

define('ENVIRONMENT', 'development');

再刷新。常见报错包括：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

Parse error: syntax error, unexpected token → PHP 版本太低（CI4 要求 PHP 8.0+）或模板里写了非法语法
Class 'RegisterModal' not found → 模型类名/文件名不匹配，或命名空间漏写 use App\Models\RegisterModal;
Call to undefined method App\Models\RegisterModal::findAll() → 模型没继承 CodeIgniter\Model

验证控制器是否真执行到了 view() 且数据传对了

别只信逻辑，加一句临时调试输出，确认流程走到哪了：

public function index()
{
    $registerModal = new RegisterModal();
    $data['tb_bills'] = $registerModal->orderBy('id', 'DESC')->findAll();
    // 加这句，看是否执行到这里
    echo '<!-- data count: ' . count($data['tb_bills']) . ' -->';
    return view('register-bill', $data);
}

然后在浏览器“查看页面源代码”，搜 data count。如果没看到，说明卡在上面某步（比如模型查询抛异常但被静默吞了）；如果看到了但页面还是白，重点查视图文件本身：

确认 app/Views/register-bill.php 存在且路径拼写完全一致（CI4 区分大小写）
检查视图里是否用了未定义变量，比如 $tb_bills 传了但模板里写成 $bills，empty($tb_bills) 就会判为 true，整个 块跳过
避免在视图里写可能出错的 PHP 逻辑，比如直接调用未初始化的对象方法


排除 HTML 解析中断导致的伪空白
即使 PHP 正常输出，HTML 结构错误也会让浏览器放弃后续渲染。典型表现是：源代码里能看到开头几行 HTML，但后面全没了。

打开浏览器“查看页面源代码”，从底部往上删内容，每次删一段后刷新，直到页面出现——最后删掉的那块就是问题源头
常见罪魁：<script></script> 标签没闭合、 或  里写了未转义的  字符、模板中混用了 Blade 风格的 {{ }} 语法（CI4 视图是原生 PHP）

用 W3C 验证器（validator.w3.org）粘贴源代码，重点关注 Unclosed element 和 Stray end tag 报错

最易被忽略的一点：CI4 的视图是直接 include 执行的，任何语法错误、未捕获异常、甚至 exit 都会让后续 HTML 彻底消失——所以白屏时，永远先确认 PHP 错误有没有打出来，而不是急着改 HTML 或 JS。