直接用 Composer 安装 owen-it/laravel-auditing：composer require owen-it/laravel-auditing；注意包名拼写准确，安装后自动注册服务提供者，需发布迁移并运行 php artisan migrate 创建 audits 表，模型启用审计需 use Auditable trait 且实现 AuditableContract 接口。
composer怎么安装laravel auditing_composer如何引入owen-it/laravel-auditing自动记录模型数据变更日志【教程】
直接用 Composer 安装 owen-it/laravel-auditing
它不是 Laravel 官方包，但维护活跃、Laravel 9/10 兼容良好，安装就是一条命令：composer require owen-it/laravel-auditing。注意别拼错包名——owen-it/laravel-auditing 中的 owen-it 是作者 GitHub 组织名，不是 owenit 或 owen，拼错会报 Package not found。
安装后自动注册服务提供者（Laravel 5.5+ 支持自动发现），无需手动加到 config/app.php；但如果你用的是 Laravel 5.4 或禁用了自动发现，得手动在 providers 数组里加一行：OwenIt\Auditing\AuditingServiceProvider::class。
发布迁移文件并运行 migrate
审计日志要存进数据库，必须先生成并执行迁移。执行：php artisan vendor:publish --provider="OwenIt\Auditing\AuditingServiceProvider" --tag="migrations"。这会把 create_audits_table.php 迁移文件复制到 database/migrations/ 目录下。
常见错误：没运行这步就直接 php artisan migrate，结果报错 Base table or view not found: 1146 Table 'xxx.audits' doesn't exist。迁移文件生成后，再跑一次 php artisan migrate 就行。
如果项目已上线，别直接删库重迁——audits 表可独立存在，不影响主业务表
默认迁移使用 bigIncrements，适合高并发场景；如确定数据量极小，可手动改成 increments 减少索引体积
表名固定为 audits，不建议改；若真要改，需同时在 config/audit.php 里调整 table 配置项
给模型开启审计功能
不是所有模型都要审计，只在需要记录变更的模型里加 Auditable trait 和接口即可。例如：use OwenIt\Auditing\Contracts\Auditable as AuditableContract;
use OwenIt\Auditing\Auditable;
class User extends Model implements AuditableContract
{
use Auditable;
}
关键点：
必须实现 AuditableContract 接口，否则运行时会报 Class name must be a valid object or a string 类错误
Auditable trait 默认监听 created、updated、deleted、restored 四个事件；想关掉某个（比如不想记 soft-delete 的 deleted），在模型里设：protected $auditInclude = ['name', 'email']; 或 protected $auditExclude = ['password'];
如果模型用的是自定义主键（非 id），记得设置：protected $auditInclude = ['your_primary_key']; 并确保该字段被包含在审计字段中，否则日志里 auditable_id 可能为空
审计日志查不到？检查配置和软删除行为
最常遇到的情况是：改了数据，但 audits 表里没新记录。优先排查这三处：
whppwxzx.watchpg.com
xappwxzx.watchpg.com
syppwxzx.watchpg.com
dgppwxzx.watchpg.com
tjppwxzx.watchpg.com
csppwxzx.watchpg.com
cqppwxzx.watchpg.com
fsppwxzx.watchpg.com
hzppwxzx.watchpg.com
njppwxzx.watchpg.com
suppwxzx.watchpg.com
wxppwxzx.watchpg.com
bj8wxpp.watchpg.com
cd10wxpp.watchpg.com
gz11wxpp.watchpg.com
sz12wxpp.watchpg.com
zz13wxpp.watchpg.com
heb14wxpp.watchpg.com
wh15wxpp.watchpg.com
xa16wxpp.watchpg.com
qd17wxpp.watchpg.com
sy18wxpp.watchpg.com
dg19wxpp.watchpg.com
tj20wxpp.watchpg.com
cs21wxpp.watchpg.com
cq22wxpp.watchpg.com
fs23wxpp.watchpg.com
hz24wxpp.watchpg.com
nj25wxpp.watchpg.com
su26wxpp.watchpg.com
vconwx.watchpg.com
8wxvcon.watchpg.com
bjvconwx.watchpg.com
shvconwx.watchpg.com
cdvconwx.watchpg.com
gzvconwx.watchpg.com
szvconwx.watchpg.com
zzvconwx.watchpg.com
hebvconwx.watchpg.com
whvconwx.watchpg.com
xavconwx.watchpg.com
qdvconwx.watchpg.com
syvconwx.watchpg.com
dgvconwx.watchpg.com
tjvconwx.watchpg.com
csvconwx.watchpg.com
cqvconwx.watchpg.com
模型是否真的用了 Auditable trait 且实现了接口——漏一个就完全不触发
是否启用了软删除（SoftDeletes）但没在模型里加 use SoftDeletes;？此时 delete() 实际是 update 操作，而默认审计不监听 updated 对 soft-deleted 记录的变更，需显式开启：protected $auditInclude = ['deleted_at'];
配置文件 config/audit.php 是否被意外修改？尤其 enabled 设为 false，或 implementation 指向了错误类——首次发布配置后，Laravel 不会自动覆盖已有文件，改配置得手动确认
审计本身不阻塞主流程，但大量高频更新模型时，每条变更写一次 audits 表可能拖慢响应；如只需关键操作留痕，建议用 $model->auditCustom('user_profile_updated', [...]) 手动触发，比全自动更可控。
