Magento 2.2.1如何通过分类ID获取产品集合？

嘿，我在Magento 2.2.1里处理过不少分类取产品集合的坑，咱们一步步来搞定这个问题！

先看最常见的错误原因和正确实现代码 #

很多人踩坑都是因为用了错误的集合加载方式，或者依赖注入没做好。下面是经过验证的两种实现方式，优先推荐依赖注入的最佳实践：

1. 依赖注入方式（项目开发首选） #

在自定义模块的类里注入必要的依赖，避免直接实例化类导致的兼容性问题：

<?php
namespace Vendor\Module\Model;

use Magento\Catalog\Model\ResourceModel\Product\CollectionFactory;
use Magento\Catalog\Model\CategoryFactory;
use Magento\Framework\Exception\NoSuchEntityException;

class CategoryProducts
{
    protected $productCollectionFactory;
    protected $categoryFactory;

    public function __construct(
        CollectionFactory $productCollectionFactory,
        CategoryFactory $categoryFactory
    ) {
        $this->productCollectionFactory = $productCollectionFactory;
        $this->categoryFactory = $categoryFactory;
    }

    public function getProductsByCategoryId($categoryId)
    {
        try {
            $category = $this->categoryFactory->create()->load($categoryId);
            
            // 先检查分类是否存在，避免无效ID导致的报错
            if (!$category->getId()) {
                throw new NoSuchEntityException(__('Category with ID %1 does not exist.', $categoryId));
            }

            $productCollection = $this->productCollectionFactory->create();
            $productCollection->addAttributeToSelect('*')
                ->addCategoryFilter($category) // 官方推荐的分类关联方法，比手动过滤category_id可靠
                ->addAttributeToFilter('status', \Magento\Catalog\Model\Product\Attribute\Source\Status::STATUS_ENABLED)
                ->addAttributeToFilter('visibility', \Magento\Catalog\Model\Product\Visibility::VISIBILITY_BOTH);

            return $productCollection;
        } catch (\Exception $e) {
            // 可以根据需求记录日志或者抛出友好异常
            throw new \Exception(__('Failed to load products: %1', $e->getMessage()));
        }
    }
}

2. 模板/块中临时测试（不推荐用于正式项目） #

如果只是临时在模板里测试效果，可以这么写，但正式项目别这么干——违反依赖注入原则，后期维护会很麻烦：

<?php
$categoryId = 5; // 替换成你的目标分类ID
$category = $block->getLayout()->createBlock(\Magento\Catalog\Model\Category::class)->load($categoryId);
$products = $block->getLayout()->createBlock(\Magento\Catalog\Model\ResourceModel\Product\Collection::class)
    ->addAttributeToSelect('*')
    ->addCategoryFilter($category)
    ->addAttributeToFilter('status', 1)
    ->addAttributeToFilter('visibility', [2,4]);
?>

常见报错的排查步骤 #

如果按上面的代码还是报错，按下面的顺序排查：

• 确认分类ID是否正确：去后台分类管理页面，检查目标分类的实际ID，别把分类路径ID当成分类ID
• 检查权限：如果是CLI命令执行，确保执行用户有足够权限访问产品和分类资源；前台的话，确认当前用户能看到该分类的产品
• 清理缓存：执行php bin/magento cache:flush，Magento 2.2.1的缓存经常会导致数据加载异常
• 查看错误日志：去var/log/system.log和var/log/exception.log里找具体报错信息——比如“分类不存在”“属性不存在”之类的，日志能帮你快速定位问题
• 验证依赖注入：如果用了DI方式，检查di.xml配置是否正确，类的构造函数有没有注入错误的依赖

额外提醒 #

Magento 2.2.1是比较老旧的版本，存在不少已知bug和安全漏洞，条件允许的话尽量升级到2.3.x或2.4.x的稳定版本，能减少很多奇怪的问题。

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