Dart 2.17/Flutter3环境下如何正确创建全局唯一单例类

Dart 2.17 版本收紧了工厂构造函数的返回值类型校验规则，旧版本中宽松的类型推断允许工厂构造函数隐式匹配静态私有实例的类型，升级后默认开启的强类型校验（Flutter 3默认集成的flutter_lints规则集默认开启严格类型检查）会识别到类型匹配风险，抛出编译错误。

不需要调整原有实现逻辑，仅需给静态实例显式声明类型，消除类型推断的歧义即可，修复后代码完全兼容你之前的调用方式，不需要修改业务侧调用FBServices()的代码：

class FBServices {
  FBServices._privateConstructor();
  // 显式标注实例类型，避免Dart类型推断偏差
  static final FBServices _instance = FBServices._privateConstructor();

  factory FBServices() {
    return _instance;
  }
}

该实现完全满足全局单例的要求：Dart中static final字段本身是懒加载机制，_instance只会在第一次被访问时初始化一次，后续所有工厂构造函数调用都会返回同一个实例，贯穿整个应用生命周期。

如果可以接受调整调用方式，Dart 2.17下更推荐直接使用静态常量实例的写法，完全规避工厂构造函数的类型校验问题，代码更简洁，可维护性更高：

class FBServices {
  // 私有构造，禁止外部手动实例化
  FBServices._privateConstructor();
  // 全局唯一实例，默认懒加载
  static final FBServices instance = FBServices._privateConstructor();
}

使用时直接通过FBServices.instance获取实例即可，懒加载特性和工厂构造写法完全一致，不会额外占用启动资源。

实现注意事项：

• 不要额外给静态实例加late关键字手动标记懒加载，Dart中顶层/静态的final字段默认自带懒加载特性，加late反而可能引入不必要的空安全风险。
• 不要将单例实例实现为顶层变量，会破坏类的封装性，私有构造+静态实例的写法可以完全禁止外部创建非法实例。

带初始化参数的单例适配 #

如果你的单例需要在首次创建时传入配置参数，可以使用如下写法适配Dart 2.17的类型校验：

class FBServices {
  final String appKey;
  FBServices._privateConstructor({required this.appKey});
  
  static FBServices? _instance;
  factory FBServices({required String appKey}) {
    // 首次调用时传入参数创建实例，后续调用忽略传入参数返回已有实例
    _instance ??= FBServices._privateConstructor(appKey: appKey);
    return _instance!;
  }
}

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