PHP 属性类型为什么会触发 TypeError

PHP类型属性在写入时会检查值是否符合声明。不兼容赋值会触发TypeError；标量值是否允许隐式转换，还取决于写入位置的strict_types设置。另一种常见错误是读取未初始化属性，它通常是Error，应与赋值类型不匹配分开排查。

官方地址：https://www.php.net/

先确定异常发生在赋值还是读取

先看异常类、属性名称和堆栈中的具体赋值位置。声明int的属性收到数组，或者非空属性收到null，优先检查输入类型；如果提示属性在初始化前不能访问，则先检查构造与填充路径。不要只看到“属性”两个字就统一修改类型。

quantity = '18'; // 严格赋值不接受数字字符串。
} catch (TypeError $e) {
    echo get_class($e), PHP_EOL; // 演示异常类别，不输出业务敏感值。
}

这段示例用于展示严格赋值的最小场景，没有在本文环境执行。排查真实数据时，可以记录get_debug_type得到的类型名称，避免将完整请求或用户资料写入日志。

检查赋值位置的严格模式

对普通用户代码的直接属性写入，检查执行赋值语句的文件，而不是只检查类定义文件。弱模式可能把可转换的数字字符串写成整数；严格模式拒绝这种标量转换。把类声明在严格文件中，并不保证其他文件中的每次直接赋值都采用相同策略。

类型约束并不因弱模式而消失。任意字符串、数组或不兼容对象不会因此变成合法int。反射、ORM及其他内部调用路径还可能采用与手写赋值不同的转换行为，不能用其中一次成功反推全部路径都接受同样的数据。

也不要简单地关闭strict_types来消除异常。这样可能把类型错误隐藏成业务值变化。应先决定接口允许数字字符串、原生整数还是空值，再在边界实现该约定。

在外部输入边界转换并拒绝非法值

以下示例面向PHP 8.0及以上，约定库存数量为正整数，接受原生整数或不带符号、空格、前导零的十进制字符串。把文本格式和整数范围都确认后，才给属性赋值：

 0) {
        return $raw; // 原生整数仍需满足业务范围。
    }
    if (!is_string($raw) || preg_match('/^[1-9][0-9]*$/D', $raw) !== 1) {
        throw new InvalidArgumentException('quantity格式不合法');
    }
    $value = filter_var($raw, FILTER_VALIDATE_INT, [
        'options' => ['min_range' => 1, 'max_range' => PHP_INT_MAX],
    ]);
    if ($value === false) {
        throw new InvalidArgumentException('quantity超出整数范围');
    }
    return $value; // 已检查范围，避免盲目强转导致溢出或截断。
}

final class StockInput {
    public int $quantity;
    public function __construct(mixed $raw) {
        $this->quantity = parseQuantity($raw);
    }
}

try {
    $input = new StockInput('18'); // 边界明确将合法字符串转成整数。
    echo $input->quantity, PHP_EOL;
} catch (InvalidArgumentException $e) {
    // 上层可转换成输入错误响应，不继续使用未构造成功的对象。
    echo '输入不合法', PHP_EOL;
}

这里没有用(int)处理任意输入，因为“18件”、小数、布尔值或空值的处理必须由业务协议决定。若数量允许0，需要同步修改格式规则和范围，不能只改一处。

让构造函数保证属性已经就绪

public ?int $quantity允许null，但没有默认值时仍可能处于未初始化状态。如果业务确实允许“未知”，可以明确写成public ?int $quantity = null；如果未知值不合法，则通过构造函数提供必需数据，不能为了不报错统一改成可空。

isset在属性为null和未初始化时都可能返回false，因此不能仅靠它区分两者。需要诊断初始化状态时，可使用ReflectionProperty的isInitialized；业务逻辑更适合通过完整构造约束减少中间状态。

ORM水合、反序列化和手工数组映射要分别检查。某条路径绕开构造函数，可能让本来在构造函数里完成的初始化与业务校验没有发生。应修复该路径的输入映射，而不是在每个读取点随意补一个默认0。

用相反输入确认修复边界

对上面的解析约定，18和“18”应被接受；null、true、“18件”、空字符串、带前导零的“018”和超过PHP_INT_MAX的数字文本应被拒绝。这个列表是预期行为说明，不是本次测试结果。真实系统还应核对数据库驱动返回值与HTTP输入格式，避免只覆盖一个来源。

最后回到堆栈，确认被修复的是首次错误赋值的位置。若TypeError消失却出现未初始化Error，通常说明对象仍可能在数据准备完成前被读取，需要继续修复构造或水合流程。

属性声明int后能直接接收数据库的数字字符串吗？

不要依赖驱动和写入路径恰好发生隐式转换。边界明确解析，再传递整数，行为更清楚。

可空属性为什么仍提示未初始化？

允许null和已经赋值为null是不同状态。默认值或构造函数需要明确建立初始状态。

捕获TypeError后继续执行是否算修复？

捕获只改变错误处理方式。属性仍可能没有获得合法值，应阻止不完整对象进入后续业务。

官方资料：类型声明、属性与初始化、类型属性写入语义。