正确写法是database_url="sqlite:///%kernel.project_dir%/var/app.db"，需保留%kernel.project_dir%变量、用正斜杠、确保var/目录存在且可写，doctrine.yaml中server_version设为sqlite、charset设为utf8mb4，并禁用pdo持久连接。
直接在 .env 文件里写 DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db" 就能跑起来，但实际部署时容易因路径、权限或编码问题失败——关键不是“能不能连”，而是“连得稳不稳、迁得顺不顺”。
怎么写对 DATABASE_URL 字符串
SQLite 的 URL 格式必须严格匹配 Doctrine 要求，不能漏掉协议头、路径占位符或转义字符：
-
%kernel.project_dir%是 Symfony 提供的动态路径变量，必须原样保留，不能替换成./或绝对路径（否则迁移命令会找不到文件） - 路径中若含空格或中文，
%kernel.project_dir%会被自动 urlencode，但手动写的路径不会，容易报SQLSTATE[HY000] [14] unable to open database file - Windows 下反斜杠
\不被识别，必须用正斜杠/，例如：sqlite:///C:/myproject/var/app.db - 如果想用内存数据库做单元测试，写成
sqlite:///:memory:，注意冒号后有三个斜杠
doctrine.yaml 里必须配 server_version 和 charset
Doctrine 默认按 MySQL 行为推断 SQL 语法，SQLite 不支持 ALTER COLUMN 等操作，不显式声明版本会导致迁移失败或生成错误 SQL：
- 在
config/packages/doctrine.yaml中，server_version必须设为sqlite（不是数字，是字符串），否则doctrine:migrations:diff可能生成不兼容语句 -
charset推荐设为utf8mb4，虽然 SQLite 实际按 UTF-8 存储，但设成utf8会导致 emoji 插入被截断 - 别忽略
options段：加PDO::ATTR_PERSISTENT: false，SQLite 不支持持久连接，开了反而报错
第一次运行前要手动创建 var/ 目录并赋权
SQLite 需要写入 .db 文件，但 Symfony 默认不自动创建 var/ 子目录，更不会给它写权限：
- 执行
php bin/console doctrine:database:create前，先确认var/目录存在且 Web 服务器用户（如 www-data 或 _www）有写权限 - 如果用
symfony serve本地开发，常见错误是file_put_contents(/path/var/app.db): failed to open stream: Permission denied，此时要chmod 775 var/或改属组 - 不要把数据库文件放在
public/下——它会被直接 HTTP 访问，泄露全部数据
迁移命令和实体生成要注意 SQLite 限制
SQLite 缺少很多标准 SQL 功能，Doctrine 迁移工具默认不校验这些边界，等你上线才爆错：
-
doctrine:migrations:diff生成的迁移文件里，如果出现CHANGE COLUMN或DROP COLUMN，必须手动删掉——SQLite 不支持，得用CREATE TABLE AS SELECT曲线救国 - 用
make:entity生成字段时，避免选datetime类型（Doctrine 会映射成DATETIME，但 SQLite 实际存字符串），改用string+ 手动格式化更稳 -
doctrine:schema:update --force在 SQLite 上禁用，它会绕过迁移历史直接改表，导致后续migrate命令混乱
最常被跳过的点：SQLite 数据库文件路径在不同环境（dev/test/prod）下必须一致，否则迁移版本表（doctrine_migration_versions）会写到不同文件里，造成“已执行却提示未执行”的状态错乱。
