CakePHP 3.x关联数据保存异常：支付数据未存且现参数类型警告

1. 先拆解警告的核心原因 #

你看到的mb_strlen() expects parameter 1 to be string, array given警告，本质是某个字符串类型的验证规则（比如minLength、notEmpty）被错误地应用到了数组上。结合Payments数据没保存的现象，大概率是你的关联数据格式不对，导致框架把整个Payments数组当成了Applications表某个字符串字段的值去验证。

2. 先检查关联保存的数据格式是否合规 #

CakePHP中一对多（Applications hasMany Payments）的保存，要求提交的数据必须是嵌套的二维数组结构，示例如下：

// 正确的数据结构
$data = [
    'Applications' => [
        'name' => '申请人姓名',
        'apply_date' => '2024-05-20'
        // 其他Applications字段
    ],
    'Payments' => [
        [
            'amount' => 1500,
            'payment_method' => '支付宝'
            // 其他Payments字段
        ]
        // 多条支付记录的话，继续添加子数组即可
    ]
];

如果你的Payments数据没有嵌套成二维数组，或者键名写错（比如用了单数Payment而非复数Payments），框架就无法识别这是关联数据，反而会把它当成Applications表的某个字段值，触发类型错误。

3. 检查控制器的保存代码 #

你在ApplicationsController.php第58-59行的代码大概率存在以下问题：

• 只用了save()方法（这个方法只会保存主模型数据，不会处理关联），没使用saveAssociated()或者在patchEntity时指定关联
• 传递给保存方法的数据结构错误，比如把Payments数组直接塞进了Applications的数组里

正确的保存代码示例：

public function add()
{
    $application = $this->Applications->newEmptyEntity();
    if ($this->request->is('post')) {
        // 必须指定associated参数，告诉框架要处理Payments关联
        $application = $this->Applications->patchEntity($application, $this->request->getData(), [
            'associated' => ['Payments']
        ]);
        // 用save()即可自动保存关联数据
        if ($this->Applications->save($application)) {
            $this->Flash->success('申请和支付记录已保存');
            return $this->redirect(['action' => 'index']);
        }
        $this->Flash->error('保存失败，请重试');
    }
    $this->set(compact('application'));
}

4. 检查前端表单的字段命名 #

如果前端表单的Payments字段命名错误，也会导致数据结构异常。正确的命名格式应该是：

<!-- 单条支付记录的字段示例 -->
<input type="number" name="Payments[0][amount]" placeholder="支付金额">
<input type="text" name="Payments[0][payment_method]" placeholder="支付方式">

如果写成了name="Payments[amount]"，就会把Payments变成一维数组，框架无法识别为关联数据，进而触发验证错误。

5. 最后检查验证规则 #

打开PaymentsTable.php和ApplicationsTable.php，确认：

• Payments表的验证规则没有错误应用到数组类型字段上
• Applications表的验证规则里没有误加payments这类关联字段的验证（比如给payments加了notEmpty规则，而它是数组不是字符串）

内容的提问来源于stack exchange，提问作者Clement Opeoluwa Adetunji