PHP类中类型化变量使用问题：未初始化取值报错

你遇到的问题是PHP类型化属性的强制初始化规则导致的，和方法的返回类型声明无关。

核心原因 #

PHP 7.4引入的类型化属性（比如你代码里的private string $name;）有严格的初始化要求：

• 非nullable的类型化属性（如string、int）必须在构造函数执行完毕前完成初始化
• 未初始化的类型化属性处于特殊的"未设置"状态，任何读取操作（哪怕是在方法内部返回它）都会直接触发Error: Typed property ... must not be accessed before initialization

你代码里的getName()返回类型声明为?string只是表示方法可以返回string或null，但问题出在访问$this->name这个未初始化的属性本身——它既不是string也不是null，而是未初始化状态，完全不符合string类型的约束。

解决方案 #

有三种常见的解决方式，根据你的业务需求选择：

1. 将属性声明为nullable并赋默认值

如果属性确实允许为null，直接修改属性的类型声明，同时显式设置默认值为null：

class City
{
    private ?string $id = null;
    private ?string $name = null;

    public function getId(): ?string
    {
        return $this->id;
    }

    public function setId(string $id): City
    {
        $this->id = $id;
        return $this;
    }

    public function getName(): ?string
    {
        return $this->name;
    }

    public function setName(string $name): City
    {
        $this->name = $name;
        return $this;
    }
}

$city = new City();
$x = $city->getName(); // 现在返回null，不会报错

2. 在构造函数中初始化属性

如果属性不允许为null，必须在构造函数中给属性赋一个合法的string值：

class City
{
    private string $id;
    private string $name;

    public function __construct()
    {
        // 赋默认空字符串，或根据业务逻辑设置初始值
        $this->id = '';
        $this->name = '';
    }

    // 其余方法保持不变
}

这种方式保证属性始终符合string类型的约束，不会出现未初始化的情况。

3. 构造函数接收参数初始化

如果属性需要在实例化时就确定值，可以通过构造函数参数传入：

class City
{
    private string $id;
    private string $name;

    public function __construct(string $id, string $name)
    {
        $this->id = $id;
        $this->name = $name;
    }

    // 其余方法保持不变
}

// 实例化时必须传入参数
$city = new City('1', 'Beijing');

关键区别：类型化属性 vs 非类型化属性 #

非类型化属性（比如private $name;）默认会被初始化为null，而类型化属性不会——PHP设计这个规则是为了避免隐式的null值违反类型声明，提升代码的类型安全性。所以两者的行为确实不一致，这是故意的设计，不是bug。

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