Symfony安装后白屏主因是权限或缓存问题：var/cache和var/logs需CLI与Web用户共同读写，须执行cache:clear--no-warmup再cache:warmup，并检查public/index.php可执行性及错误显示是否开启。
Symfony安装后白屏，多数不是代码问题，而是权限没设对或缓存没清干净。开发环境里，Web 服务器（如 PHP 内置服务器或 Apache）和命令行用户不一致、var/cache目录不可写、路由没重载，都可能导致页面完全空白且无错误提示。
检查并修复 var/cache 和 var/logs 的写入权限
白屏最常见原因是 Web 服务无法写入缓存或日志目录：
- 运行
ls -ld var/cache var/logs，确认当前用户（如yourname）对这两个目录有rw-权限，且所有者是你自己 - 快速修复（仅限本地开发）：
sudo chown -R $(whoami):staff var/cache var/logssudo chmod -R 775 var/cache var/logs - 更稳妥的方式（推荐）：用 ACL 让 CLI 用户和 Web 用户（macOS 是
_www，Linux 是www-data）都能读写sudo chmod +a "$(whoami) allow read,write,append,file_inherit,directory_inherit" var/cache var/logssudo chmod +a "_www allow read,write,append,file_inherit,directory_inherit" var/cache var/logs
确保 bin/console 和 public/index.php 可执行
某些系统（尤其是 macOS Catalina 及更新版）会因 Gatekeeper 阻止未签名脚本执行，导致 PHP 启动失败而白屏：
- 检查执行权限：
ls -l bin/console，若没有x（如显示-rw-r--r--），运行chmod +x bin/console - 同理处理
public/index.php：chmod +x public/index.php - 如仍报错“Operation not permitted”，可能是被隔离：执行
xattr -d com.apple.quarantine bin/console public/index.php
清除缓存并强制重新生成容器
白屏也常因旧缓存残留，特别是改过路由、控制器或配置后没刷新：
- 先清空再重建（比单独
cache:clear更可靠）：php bin/console cache:clear --no-warmupphp bin/console cache:warmup - 验证路由是否生效：
php bin/console debug:router | grep your_route_name，如果没出现，说明路由根本没加载 - 开发环境也要注意：即使
APP_ENV=dev，路由和 Twig 模板仍会被缓存；--no-warmup能避免缓存干扰编译流程
开启错误显示与日志排查
白屏往往伴随错误被静默吞掉，需主动暴露问题：
- 临时启用 PHP 错误报告：在
public/index.php顶部加入ini_set('display_errors', '1'); error_reporting(E_ALL); - 查看
var/log/dev.log或var/log/prod.log，搜索CRITICAL或ERROR行 - 用内置服务器调试：
php -S localhost:8000 public/index.php，终端会直接输出 PHP 致命错误
