Magento2调用Customer Session的getData()报空值错误，求排查及最佳实践

错误根源 #

你遇到的对null调用成员函数getData()，核心原因是直接在控制器构造函数中注入Magento\Customer\Model\Session的方式不符合Magento2的依赖注入规则。

Magento2中，Customer\Model\Session是带有状态的会话对象，而控制器属于请求级别的无状态对象，直接注入会触发序列化冲突，导致容器无法正确实例化该对象，最终$this->session变为null。

修复方案 #

方案1：使用Session工厂（推荐） #

通过注入Magento\Customer\Model\SessionFactory来动态获取Session实例，这是Magento2处理有状态对象的标准方式：

<?php declare(strict_types=1);

namespace Macademy\Blog\Controller\Index;

use Magento\Customer\Model\SessionFactory;
use Magento\Framework\App\Action\HttpGetActionInterface;
use Magento\Framework\Controller\Result\RawFactory;

class ListAction implements HttpGetActionInterface
{
    private $sessionFactory;
    private $rawResultFactory;

    public function __construct(
        SessionFactory $sessionFactory,
        RawFactory $rawResultFactory
    ) {
        $this->sessionFactory = $sessionFactory;
        $this->rawResultFactory = $rawResultFactory;
    }

    public function execute()
    {
        $customerSession = $this->sessionFactory->create();
        $sessionData = $customerSession->getData();

        $result = $this->rawResultFactory->create();
        $result->setHeader('Content-Type', 'text/plain');
        $result->setContent(print_r($sessionData, true));
        return $result;
    }
}

方案2：使用Session代理类 #

如果必须在构造函数中注入，可以使用Session的代理类（由DI自动生成）：

<?php declare(strict_types=1);

namespace Macademy\Blog\Controller\Index;

use Magento\Customer\Model\Session\Proxy;
use Magento\Framework\App\Action\HttpGetActionInterface;
use Magento\Framework\Controller\Result\RawFactory;

class ListAction implements HttpGetActionInterface
{
    private $customerSession;
    private $rawResultFactory;

    public function __construct(
        Proxy $customerSession,
        RawFactory $rawResultFactory
    ) {
        $this->customerSession = $customerSession;
        $this->rawResultFactory = $rawResultFactory;
    }

    public function execute()
    {
        $sessionData = $this->customerSession->getData();

        $result = $this->rawResultFactory->create();
        $result->setHeader('Content-Type', 'text/plain');
        $result->setContent(print_r($sessionData, true));
        return $result;
    }
}

开发最佳实践 #

• 禁止直接注入有状态对象：Session、Cookie等带有状态的对象，必须通过Factory或Proxy注入，避免序列化冲突。
• 摒弃ObjectManager：坚持依赖注入（DI）模式，让容器自动管理对象生命周期，提升代码可维护性和可测试性。
• 规范控制器响应：不要使用echo、die直接输出内容，必须通过Magento的ResultFactory返回标准化响应（如Raw、Json、Page等）。
• 执行必要的部署命令：修改DI配置后，需运行以下命令刷新容器：

  bin/magento setup:upgrade
  bin/magento setup:di:compile
  

• 权限与上下文检查：操作Customer Session前，可通过$customerSession->isLoggedIn()判断用户是否登录，避免无意义的空数据操作。

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