CakePHP 4.x复合主键表无法访问Controller视图的问题求助

问题原因 #

你遇到的核心问题是：CakePHP的Table::get()方法对于复合主键，需要接收数组形式的键值对，但cake bake生成的默认控制器代码和路由仅支持单主键场景。当你传入1,1,6时，系统会把它当作一个完整的字符串主键去匹配，自然找不到对应记录。

解决方案 #

以下两种方案任选其一即可：

方案1：修改控制器方法，直接接收多个主键参数 #

修改InvoiceItemsController的view方法，把单个$id参数替换为复合主键对应的三个字段参数，直接组装成数组传给get()方法：

/**
 * View method
 *
 * @param int|null $itemId Item ID
 * @param int|null $invoiceId Invoice ID
 * @param int|null $unitId Unit ID
 * @return \Cake\Http\Response|null|void Renders view
 * @throws \Cake\Datasource\Exception\RecordNotFoundException When record not found.
 */
public function view($itemId = null, $invoiceId = null, $unitId = null)
{
    $invoiceItem = $this->InvoiceItems->get([
        'item_id' => $itemId,
        'invoice_id' => $invoiceId,
        'unit_id' => $unitId,
    ], [
        'contain' => ['Items', 'Invoices', 'Units'],
    ]);

    $this->set(compact('invoiceItem'));
}

此时访问URL格式为：
http://localhost:8765/invoice-items/view/1/1/6

方案2：配置路由支持逗号分隔的主键，在控制器中拆分 #

1. 添加路由规则
   在config/routes.php中添加针对InvoiceItems的自定义路由，允许逗号分隔的主键格式：

$routes->scope('/', function (RouteBuilder $builder) {
    // 其他路由...
    
    $builder->connect('/invoice-items/view/{id}', [
        'controller' => 'InvoiceItems',
        'action' => 'view'
    ])->setPass(['id'])->setPatterns(['id' => '[0-9,]+']);
});

2. 修改控制器方法
   在view方法中，将逗号分隔的字符串拆分为数组，和表的主键字段对应：

/**
 * View method
 *
 * @param string|null $id 逗号分隔的复合主键值
 * @return \Cake\Http\Response|null|void Renders view
 * @throws \Cake\Datasource\Exception\RecordNotFoundException When record not found.
 */
public function view($id = null)
{
    if ($id) {
        // 获取表的复合主键字段列表
        $primaryKeys = $this->InvoiceItems->getPrimaryKey();
        // 拆分逗号分隔的主键值
        $idValues = explode(',', $id);
        // 组合成键值对数组
        $keyData = array_combine($primaryKeys, $idValues);
    }

    $invoiceItem = $this->InvoiceItems->get($keyData, [
        'contain' => ['Items', 'Invoices', 'Units'],
    ]);

    $this->set(compact('invoiceItem'));
}

此时访问URL格式为：
http://localhost:8765/invoice-items/view/1,1,6

关键说明 #

• cake bake工具默认生成的代码仅适配单主键表，复合主键场景需要手动调整控制器和路由。
• Table::get()方法接收的主键参数，必须是与表主键字段顺序一致的数组（或键值对数组）。

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