Flutter出现Text组件需传入非空字符串的报错排查与处理

你当前代码中大概率触发该断言的场景按概率从高到低排序：

• 多语言翻译函数返回null：所有调用getTranslated(context, 'xxx')的位置，当翻译函数匹配不到对应语言的key值时，会返回null，直接传入Text组件就会触发data != null的断言。
• 语言实体属性为null：下拉选择语言的列表项中，lang.flag、lang.name两个字段如果初始化时未赋值，取值为null时传入Text也会触发报错。

• 所有传给Text的可能为null的字符串，统一加空值兜底：当取值为null时传入空字符串，满足Text对非空入参的要求。
  示例修改：

  // 原代码（容易触发报错）
  Text(getTranslated(context,'Assessment Form'), ...)
  // 修改后（安全写法）
  Text(getTranslated(context,'Assessment Form') ?? '', ...)
  

  需要同步加兜底的位置包括：AppBar标题、'Current Site'文本、两个CheckboxListTile的title值、语言下拉项中的lang.flag、lang.name取值。
• 如果后续代码中多语言调用场景较多，可以封装全局通用的安全Text组件，避免逐行加兜底的遗漏：

  class SafeText extends StatelessWidget {
    final String? content;
    final TextStyle? style;
    const SafeText(this.content, {super.key, this.style});
  
    @override
    Widget build(BuildContext context) {
      return Text(content ?? '', style: style);
    }
  }
  

  后续所有可能传入null字符串的位置，直接替换为SafeText(getTranslated(context, '对应key'))即可，从根源上避免同类报错。

如果仍需找到具体触发报错的位置，无需逐行排查：

• 直接查看控制台报错堆栈中，属于你项目代码的最近一行行号，对应位置的Text组件就是传入null的触发点。
• 临时在Text组件的构造函数加debug断点，当入参data为null时调试器会自动断住，直接定位问题位置。

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