出现The body might complete normally非空返回类型报错该如何处理

The body might complete normally causing null to be returned but the return type is a potentially non nullable type
这个是Dart 2.12及以上版本空安全机制触发的编译错误，核心原因是你声明的函数/方法返回值为非空类型，但代码逻辑存在没有返回任何值就走完函数体的路径，此时Dart会默认返回null，和声明的非空返回类型冲突。

常见触发场景及修复方法 #

• 场景1：条件分支未覆盖所有返回情况
  错误代码示例：

  int getScore(bool isPass) {
    if (isPass) {
      return 60;
    }
    // 非isPass分支没有return语句，默认返回null，不符合int非空要求
  }
  

  修复方式：要么补全所有分支的返回逻辑，要么将返回类型修改为可空类型int?。

• 场景2：switch语句未覆盖所有枚举值，也未设置default分支返回
  如果用枚举作为switch的判断条件，仅处理了部分枚举值的返回逻辑，剩余未处理的分支没有返回值，也会触发该报错。
  修复方式：补全所有枚举值的处理逻辑，或者增加default分支的返回语句。

• 场景3：异步函数漏写return语句
  编写async回调函数时，写完业务逻辑漏写return语句，也会触发该报错，需要检查异步方法的返回逻辑是否完整。

报错截图参考 #

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