Flutter Web部署失败：go_router包引发NavigatorObserver混入错误

DevOps 小满

2026-7-27

解决方案

问题根源

go_router 3.1.1版本的代码中使用with NavigatorObserver的写法，在较新的Dart/Flutter版本中不再兼容——NavigatorObserver是普通类，并非mixin类或mixin，而Dart 2.17+对mixin的使用规则做了严格限制，禁止将普通类作为mixin使用。

解决步骤

优先升级go_router版本：
打开项目根目录的pubspec.yaml，将go_router的版本更新至4.0.0及以上（该版本起已修复此mixin使用问题），示例配置：
```
dependencies:
  go_router: ^6.5.0 # 可替换为最新稳定版
```
执行命令更新依赖：
```
flutter pub get
```
临时应急方案（不推荐）：
若因特殊原因无法升级版本，可手动修改本地缓存的go_router代码：
1. 定位到报错文件：/root/.pub-cache/hosted/pub.dev/go_router-3.1.1/lib/src/go_router.dart
2. 将类定义行class GoRouter extends ChangeNotifier with NavigatorObserver修改为：
```
class GoRouter extends ChangeNotifier implements NavigatorObserver
```
3. 实现NavigatorObserver的所有抽象方法（如didPush、didPop等），可参考新版本go_router的实现逻辑或留空基础实现。