修改 schema_cache_type 没生效是因为：未触发首次元数据查询（如 getFields 或 find）、配置未放在数据库连接内、schema_cache_path 路径不可写或不存在、表结构变更后未手动清除缓存。
为什么修改 schema_cache_type 没生效？
ThinkPHP 默认不开启数据库字段缓存，哪怕你改了配置，schema_cache_type 设为 file 或 redis，也不代表缓存就自动工作了——它依赖「首次查询触发生成」+「后续读取复用」两步。如果没触发过 Db::name('user')->getFields() 这类元数据操作，缓存文件根本不会生成。
- 确认是否已执行过任意一次模型或 Db 查询（哪怕只是
Db::name('user')->find()），否则缓存不会初始化 -
schema_cache_type必须在数据库连接配置里设置，不是全局配置项；写在config/database.php的'connections' => ['mysql' => [...]]内部才有效 - 若使用多连接，每个连接需单独配置，共用一个
schema_cache_path时注意命名冲突（如两个连接都查user表，缓存文件会互相覆盖）
怎么让字段缓存真正起作用？
缓存启用后，ThinkPHP 会在第一次访问表结构时写入缓存，并跳过后续的 SHOW COLUMNS FROM `xxx` 查询。但这个过程对开发者是隐式的，容易误以为“没反应”。
- 手动触发一次字段读取：运行
php think optimize:schema命令（TP6.1+），它会批量生成所有配置表的缓存文件 - 开发环境可临时加日志验证：在
think/db/Connection.php的getFields()方法里打点，看是否跳过了SHOW COLUMNS执行 - 缓存文件默认存在
runtime/schema/下，文件名形如mysql_user.php，内容是 PHP 数组，可直接打开确认结构是否完整
schema_cache_path 路径写错导致缓存静默失败
这个路径不校验是否存在，也不自动创建目录。如果设成 ../cache/schema 但上级目录不可写，或路径含非法字符（如中文、空格），缓存会直接跳过写入，且无任何错误提示。
- 必须确保路径存在且 Web 进程有写权限，推荐用
__DIR__ . '/../runtime/schema'这类绝对路径 - 不要用相对路径如
./schema，TP 在不同入口（命令行 vs HTTP）下工作目录不同，容易失效 - Redis 缓存类型下，
schema_cache_key默认是think_schema_+ 连接名 + 表名，注意 Redis key 长度限制和特殊字符转义（如表名含-或大写字母）
表结构变更后缓存不更新怎么办？
这是最常被忽略的点：ThinkPHP 不监听数据库 DDL 变更，也不会自动清理旧缓存。加字段、删索引后，旧缓存还在，代码仍按老结构解析，轻则字段取不到，重则抛 Unknown column 错误。
立即学习“PHP免费学习笔记（深入）”；
- 上线前务必清空缓存：运行
php think clear:cache --data或手动删掉runtime/schema/全部文件 - CI/CD 流程中，在数据库迁移脚本执行后，追加一条
php think clear:cache --schema（TP6.2+ 支持该参数） - 开发阶段可临时关闭缓存：在连接配置里设
'schema_cache_type' => 'none'，避免反复手动清理
字段缓存本身不复杂，但它的生命周期完全脱离数据库事件，全靠开发者主动管理。一旦忘了清缓存，问题往往出现在上线后，而且报错位置和实际原因隔得很远。
