根本原因是FrankenPHP默认以www-data用户运行，而Symfony的var/cache和var/log目录未预设正确属主权限，导致写入失败；需在Dockerfile中提前执行mkdir -p /app/var/cache /app/var/log && chown -R www-data:www-data /app，并确保挂载整个项目目录而非仅public/。
FrankenPHP 容器启动时为什么 Symfony 报 file_put_contents(/app/var/cache/prod/App_KernelProdContainer.php): failed to open stream
根本原因是 FrankenPHP 的默认容器镜像以非 root 用户（www-data）运行，而 Symfony 的 var/cache 和 var/log 目录在首次构建时未预设正确属主和权限，导致运行时写入失败。
解决方式不是改用户，而是提前初始化目录权限：
- 在
Dockerfile中添加RUN mkdir -p /app/var/cache /app/var/log && chown -R www-data:www-data /app/var - 确保
docker-compose.yml挂载的是整个项目目录（./:/app），而非只挂载public/；否则var/不在容器内，缓存根本无法生成 - 不要依赖
symfony console cache:warmup在容器启动后执行——FrankenPHP 启动即服务，必须在 ENTRYPOINT 前完成缓存预热
如何让 FrankenPHP 正确加载 Symfony 的环境变量和 .env 文件
FrankenPHP 默认不读取 .env，它依赖 PHP 的 getenv() 或 $_SERVER，而 Symfony 的 Dotenv 组件需显式启用。常见错误是环境变量全为 null，数据库连不上、密钥为空。
关键操作有两处：
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php顶部（use语句前）插入：if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) { require dirname(__DIR__).'/config/bootstrap.php'; }这行确保 Dotenv 被加载 - 在
docker-compose.yml的 FrankenPHP 服务中，用environment:显式传入必要变量（如APP_ENV=prod,APP_SECRET,DATABASE_URL），或挂载.env到容器内并设DOTENV_FILE=/app/.env - 注意：生产环境禁用
Dotenv::createUnsafeImmutable()，应改用Dotenv::createMutable()并确保.env不被 Web 访问（FrankenPHP 默认禁止访问.env，但要检查public/外路径是否暴露）
docker run -v .:/app/public 为什么会导致 Symfony 路由 404
这是 FrankenPHP 官方文档里最易误导的写法。挂载 ./:/app/public 实际把整个项目根目录（含 src/, config/, var/）都压到了 /app/public 下，Symfony 找不到 config/ 和 src/，自动 fallback 到默认路由或报错。
正确挂载方式必须分层：
-
-v $(pwd):/app：挂整个项目到/app（保持原始结构） -
-v $(pwd)/public:/app/public：单独覆盖 public 目录（可选，仅当需动态替换静态资源） - 同时在容器启动命令中指定入口点：
frankenphp php-server --document-root /app/public - 如果你用的是
dunglas/frankenphp镜像，它默认 document-root 就是/app/public，所以只需确保/app/public存在且含index.php
生产环境启用 HTTPS 和 HTTP/3 后，Symfony 的 url() 生成链接仍是 http://
FrankenPHP 自动处理 TLS 终止，但 Symfony 不知道请求来自 HTTPS，仍按 $_SERVER['HTTP_X_FORWARDED_PROTO'] 或 $_SERVER['HTTPS'] 判断协议。若没透传，所有生成 URL 都是 http。
必须配置反向代理信任：
- 在
config/packages/framework.yaml中设置：framework: trusted_proxies: '**' # 或更安全的：'172.16.0.0/12,192.168.0.0/16' - 确保 FrankenPHP 容器或前置 Caddy/Nginx 设置了
X-Forwarded-Proto: https头（Docker 镜像默认已设，但自定义 Caddyfile 需手动加header_up X-Forwarded-Proto https） - 验证方式：在控制器中 dump
$request->getSchemeAndHttpHost()，应返回https://example.com而非http://example.com
FrankenPHP 对 Symfony 的支持很直接，但它的“零配置”假定和 Symfony 的目录约定之间存在几处隐性冲突，最容易卡在缓存权限和环境变量加载上。别跳过 chown 和 bootstrap.php 这两步——它们不是可选项，是 FrankenPHP + Symfony 能跑通的硬性前提。
