网站打不开（空白页_404_500）问题_已解决

（一）空白页（无任何提示，仅显示空白）

常见原因

排查与解决方案

1. 优先开启调试模式（参考核心排查前提1），开启后若显示具体错误，按错误提示处理（如语法错误、类找不到）；若仍空白，检查 PHP 配置。
2. 检查 runtime 目录权限：ThinkPHP 需向 runtime 目录写入缓存、日志文件，权限不足会导致空白页。执行命令 chmod -R 755 runtime，并确保目录属主与 Web 服务用户（如 www-data、nginx）一致，避免权限冲突。
3. 检查 PHP 错误显示配置：编辑 php.ini 文件，设置display_errors = On、error_reporting = E_ALL，重启 PHP-FPM 服务（如 sudo systemctl restart php8.1-fpm），此时空白页会显示具体错误信息，再针对性修复。
4. 排查自动加载失败：若提示“Class not found”，大概率是 Composer 自动加载文件未生成或更新，进入项目根目录，执行 composer dump-autoload 重新生成自动加载文件，若未安装依赖，先执行 composer install --no-dev（生产环境）。

（二）404错误（页面不存在）

常见原因

排查与解决方案

1. 检查伪静态配置（核心原因）：ThinkPHP 默认使用 Pathinfo 模式，需服务器配置伪静态规则，将请求转发到入口文件 index.php，不同服务器配置不同：
   1. Nginx 环境：编辑站点配置文件，添加如下规则，保存后重启 Nginx（sudo systemctl reload nginx）： location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php/$1 last; break; } }
   2. Apache 环境：确保启用 mod_rewrite 模块，在项目根目录创建 .htaccess 文件，写入如下内容： RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 (QSA,PT,L)
   3. 宝塔面板：进入网站设置→伪静态，选择“ThinkPHP 6”模板（TP6/8 适用），若无该模板，手动粘贴上述 Nginx/Apache 规则，避免使用旧版 TP5 规则或其他框架规则。
2. 检查网站根目录指向：ThinkPHP 6+ 入口文件位于 public 目录，若根目录指向项目根目录（而非 public），会导致 404 或报错。修改服务器/Nginx/Apache 配置，将根目录指向 /项目路径/public，宝塔面板可直接在“网站目录”中修改，无需移动入口文件。
3. 排查路由与大小写问题：Linux 环境下文件系统大小写敏感，UserController.php 与 usercontroller.php 视为不同文件，需确保控制器、方法名大小写与文件路径一致；同时检查路由配置（route/app.php），确认路由规则正确，避免路由不存在导致 404。

（三）500错误（内部服务器错误）

常见原因

排查与解决方案

1. 查看服务器日志（核心）：执行 tail -n50 /var/log/nginx/error.log（Nginx）或 tail -n50 /var/log/apache2/error.log（Apache），查看具体错误信息，如“PHP Fatal error”“内存溢出”“扩展缺失”等，针对性处理。
2. 确认环境兼容：核对 ThinkPHP 版本与 PHP 版本匹配（如 TP5.1 支持 PHP 5.6+，TP8 支持 PHP 8.0+），若版本不匹配，升级/降级 PHP 版本，同时确保 PDO、mbstring、cURL 等核心扩展已安装启用。
3. 排查数据库连接错误：若日志提示数据库连接失败，检查 config/database.php 配置，核对数据库主机、端口、用户名、密码、数据库名是否正确，确保数据库服务正常运行，且服务器能访问数据库端口（如 3306），避免密码错误、数据库名拼写错误等低级问题。
4. 解决服务器配置限制：若提示“内存溢出”，编辑 php.ini，修改 memory_limit = 128M（根据需求调整）；若提示“执行时间超时”，修改 max_execution_time = 60，重启 PHP-FPM 生效；CentOS/RHEL 环境若开启 SELinux，执行 sudo setsebool -P httpd_can_network_connect 1 临时放行，避免其阻止 PHP 写入文件或连接数据库。
5. 排查代码致命错误：若日志提示具体文件和行号的致命错误（如语法错误、数组越界），定位到对应代码，修正错误；若无法定位，可通过注释部分代码，逐步缩小问题范围，或使用 dump()、halt() 函数追踪程序执行流程。