CakePHP按主分类获取最新20条商品及partitionable库使用问题排查

你当前的核心问题是关联类型使用错误，且关联配置未指定正确的筛选主键：

1. 你的Categories到Products实际是hasManyThrough关系（通过中间表ProductCategories，且ProductCategories与Products为一对多关联），但你错误使用了适用于多对多场景的partitionableBelongsToMany关联类型，导致生成的SQL筛选的是中间表ProductCategories的ID，而非目标表Products的ID。
2. 当同一个产品分类下有多个商品进入某主分类的前N条结果时，中间表ID会在子查询结果中重复，外层IN查询会自动去重，导致该中间表下的所有商品都会被查询出来，最终单个主分类返回的商品数超过限制。

修改CategoriesTable中的关联配置，使用partitionableHasManyThrough关联类型，并显式指定正确的外键配置：

$this
    ->partitionableHasManyThrough('RecentProducts', [
        'className' => 'Products',
        'through' => 'ProductCategories',
        // ProductCategories表指向Categories表的外键
        'foreignKey' => 'category_id',
        // Products表指向ProductCategories表的外键
        'targetForeignKey' => 'product_category_id',
        // ProductCategories表的主键
        'throughForeignKey' => 'id',
    ])
    ->setLimit(9)
    ->setSort([
        'RecentProducts.created' => 'DESC',
    ])
    // 显式指定按主分类ID分区
    ->setPartitionKey('ProductCategories.category_id');

修改后生成的SQL会改为筛选Products表的ID，每个主分类最多返回9条符合条件的最新商品，不会出现数量超出限制的问题。

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