Dart初始化类时List.length断言失效问题及解决方法

问题根源 #

1. Dart断言的运行机制：assert仅默认在debug开发模式下执行，release编译会自动移除所有断言逻辑，这是语言层面的默认行为。
2. @immutable类的构造函数写法：如果使用const构造函数初始化@immutable类，断言必须放在构造函数初始化列表中，不能写在构造函数体内（const构造函数不允许有执行语句）。

分步解决方案 #

1. 确认运行模式为debug #

• 纯Dart项目：直接用dart run启动，默认开启断言；避免使用dart run --no-asserts或dart compile exe（默认release）。
• Flutter项目：用flutter run启动（默认debug模式），不要加--release参数。

2. 正确编写@immutable类的断言 #

针对@immutable类，无论使用const还是普通构造函数，都要确保断言位置正确：

示例代码（const构造函数）

import 'package:flutter/foundation.dart';

@immutable
class TestClass {
  final List<int> listData;
  final String strData;

  // 断言必须放在初始化列表中
  const TestClass({required this.listData, required this.strData})
      : assert(listData.length >= 0 && listData.length <= 4, 'List长度需在0-4之间'),
        assert(strData.length >= 0 && strData.length <= 4, 'String长度需在0-4之间');
}

示例代码（普通构造函数）

import 'package:flutter/foundation.dart';

@immutable
class TestClass {
  final List<int> listData;
  final String strData;

  TestClass({required this.listData, required this.strData}) {
    // 普通构造函数可在体内写断言（仅debug模式生效）
    assert(listData.length >= 0 && listData.length <= 4, 'List长度需在0-4之间');
    assert(strData.length >= 0 && strData.length <= 4, 'String长度需在0-4之间');
  }
}

3. （可选）强制在release模式启用断言 #

如果业务必须在release环境保留断言，可通过编译参数开启：

• 纯Dart：dart compile exe --enable-asserts your_script.dart
• Flutter：flutter run --release --enable-asserts

注意：此操作会增大包体积并降低运行性能，仅适合特殊场景。

验证方式 #

运行代码后，若传入不符合要求的参数，控制台会抛出AssertionError并输出自定义提示信息，说明断言已生效。

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