thinkphp6.2模型中$hidden不生效的五大原因：字段名大小写/拼写错误；未通过模型方法查询（如直连db）；关联模型未单独配置$hidden；未调用tojson()而是直接输出data或toarray()；$visible、field()等与$hidden冲突或缓存未更新。
ThinkPHP6.2模型中$hidden配置不生效，不是代码写错了就是环境没对齐——常见原因就五类，按优先级从高到低排查，基本能快速定位。
字段名大小写或拼写不一致
这是最高频的坑。$hidden里的字段名必须和数据库列名完全一致，包括大小写、下划线、有无前缀。比如数据库字段是user_name，写成username或UserName都不生效；Linux服务器上password写成Password也会静默失败。
- 用
DESCRIBE your_table;查真实字段名 - 避免手敲，直接从数据库导出结构复制粘贴
- 特别注意带表前缀的字段（如
tp_user.password）——$hidden只认纯列名，不认前缀
没走模型方法，而是直连Db查询
$hidden是模型层的静态过滤机制，只在模型实例调用toArray()、toJson()、toJSON()或API自动序列化时起作用。如果用了Db::name('user')->select()或UserModel::where(...)->find()但没转成模型对象（比如漏了->withAttr()或没用->toObject()），字段根本不会被过滤。
- 确认返回的是模型实例：
UserModel::find(1)✅，Db::table('user')->find(1)❌ - 关联查询时，
with('profile')返回的关联模型也要单独设$hidden，主模型的配置不影响它 - 批量操作如
UserModel::select()返回的是模型集合，$hidden有效；但Db::select()返回原生数组，无效
JSON输出没调用toJson()，而是直接取data
很多人写return $user->data;或return $user->toArray();，结果$hidden不生效。因为toArray()虽会过滤，但若模型里定义了append动态属性，而$hidden又包含它们，部分版本可能行为不稳定。最稳妥的是显式调用toJson()。
- 正确写法：
return json($user->toJson());或return $user;（框架自动调用toJson） - 错误写法：
return json($user->data);—— 绕过所有模型过滤逻辑 - 如果用了自定义
JsonSerializable或重写了jsonSerialize()，需手动处理$hidden
与其他字段控制方式冲突
$hidden和$visible互斥，$visible优先级更高；同时用了field()或withoutField()也会影响最终输出。
- 模型里同时定义了
$visible = ['id', 'name']和$hidden = ['password']，以$visible为准，password仍会被排除，但其他字段如email也不会出现 -
UserModel::field(['id', 'name'])->find(1)会覆盖$hidden，只返回指定字段 -
withoutField('password')是运行时过滤，和$hidden叠加可能导致重复排除或逻辑混乱，建议二选一
缓存未更新或配置未加载
ThinkPHP会缓存模型元信息。改完模型类后没清缓存，旧配置仍在生效；或者模型文件没被自动加载（比如命名空间错、文件路径不对），$hidden根本没注册进去。
- 执行
php think clear:all清除全部缓存 - 检查模型类是否正确声明命名空间，例如
app\model\User对应app/model/User.php - 确认模型类被实际使用：在控制器里
use app\model\User;并实例化，而不是仅new \think\Model()
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
