Flutter Getx路由传参遇Null Check报错问题及解决问询

报错原因 #

出现Null check used on a null value错误，核心是路径参数未被正确传递或获取，常见场景包括：

• 路由跳转时未按要求传递路径参数，比如直接调用Get.toNamed('/ApartmentDetailedPage')未拼接参数，导致Get.parameters中对应key的值为null，此时用!强制解包就会触发错误。
• 参数获取时的key与路由配置中的参数名不一致，比如路由配置是:propertyName，但获取时写成Get.parameters['property_name']，导致拿到null。
• 手动拼接路径时参数包含特殊字符（如空格、中文）未编码，导致路由解析失败，参数无法被正确识别。

正确实现路径传参的步骤 #

1. 正确配置带参数的GetPage #

确保路由定义中明确声明路径参数：

GetPage(
  name: '/ApartmentDetailedPage/:propertyName/:reraId',
  page: () => ApartmentDetailedPage(),
)

2. 两种正确的参数传递方式 #

方式一：直接拼接路径字符串

// 若参数含特殊字符，用Uri.encodeComponent编码
final encodedPropertyName = Uri.encodeComponent(propertyName);
Get.toNamed('/ApartmentDetailedPage/$encodedPropertyName/$reraId');

方式二：通过parameters参数传递

这种方式无需手动处理路径拼接，Getx会自动生成正确路径：

Get.toNamed(
  '/ApartmentDetailedPage',
  parameters: {
    'propertyName': propertyName,
    'reraId': reraId,
  },
);

3. 安全获取路径参数 #

避免直接用!强制解包，改用空合并运算符提供默认值，或先校验参数有效性：

class ApartmentDetailedPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 安全获取参数，为空时返回默认空字符串
    final propertyName = Get.parameters['propertyName'] ?? '';
    final reraId = Get.parameters['reraId'] ?? '';

    // 校验参数完整性，避免后续逻辑出错
    if (propertyName.isEmpty || reraId.isEmpty) {
      return Scaffold(
        body: Center(child: Text('参数缺失或无效')),
      );
    }

    // 后续用参数请求Firestore数据
    return Scaffold(
      appBar: AppBar(title: Text(propertyName)),
      body: Center(child: Text('RERA ID: $reraId')),
    );
  }
}

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