PrestaShop调用Tax类save()方法创建税种失败问题求助

你这个是典型的Laravel Eloquent模型单模型写入异常，同框架下商品模型save正常说明ORM底层配置没问题，按以下优先级排查即可：

• 确认Tax模型正确引入
  先检查当前业务文件头部有没有引入你自己写的Tax模型，即有没有写use App\Models\Tax;。如果漏了引入，PHP可能会加载其他依赖包中同名的Tax类，这类类没有Eloquent的持久化逻辑，调用save自然不会触发数据库写入。
• 检查模型可写字段配置
  打开你的Tax模型文件，确认$fillable属性中包含了你要赋值的name、rate字段。如果没有配置可写字段，且模型没有设置$guarded = []放开所有字段赋值，Eloquent会自动拦截非白名单字段的赋值，save时对应字段为空，一旦数据库字段设了非空约束就会直接写入失败。
  正确的配置参考：

  // 文件路径：app/Models/Tax.php
  protected $fillable = [
      'name',
      'rate'
  ];
  

• 核对数据库表结构
  确认Tax模型对应的默认表（Eloquent默认自动将模型名转为复数作为表名，即Tax模型对应taxes表）真实存在，且表中确实有name、rate两个字段，字段类型和约束没有冲突：比如rate如果设为无符号小数，传入负数会报错；如果name字段设了唯一索引，重复插入相同名称也会失败。你可以直接在数据库客户端手动插入一条相同内容的记录，能快速排除字段约束类问题。
• 排查模型事件/全局作用域拦截
  检查Tax模型中是否注册了creating、saving等模型事件，或者挂载了全局作用域，这类逻辑如果做了参数校验、租户字段自动填充之类的操作，一旦逻辑中返回false会直接中断save流程，且不一定会抛出显性报错。你可以临时在代码中加调试打印，直接拿到错误信息：

  $tax = new Tax();
  $tax->name = "TVA FR 3%";
  $tax->rate = 3;
  // 打印save返回结果、模型赋值属性、执行SQL日志
  dd($tax->save(), $tax->getAttributes(), DB::getQueryLog());
  

  如果save返回false，结合打印的SQL日志和属性就能直接定位拦截点。
• 排查变量名拼写错误
  你提到自己怀疑是$taxe->save()未被识别，看你贴出的示例代码中实例化的对象变量名是$tax，确认实际运行的代码中没有出现变量名拼写错误（比如误写为$taxe、$tax1之类的），这类拼写错误会直接触发变量未定义的致命错误，查看storage/logs/下的Laravel日志文件就能直接看到对应报错。

调试时建议先开启APP_DEBUG=true，所有SQL执行错误、框架层报错都会直接展示在页面，不用盲猜问题点。

内容的提问来源于stack exchange，提问作者Baptiste L