如何清理Flutter依赖与包缓存？解决依赖版本不符问题

问题描述 #

误触VS Code的“获取包”按钮后，尽管在pubspec.yaml中固定serverpod相关包为^0.9.8版本，但项目仍自动拉取serverpod_serialization-0.9.20等最新版本，引发类型缺失、方法未实现等报错。尝试删除pubspec.lock、.pub-cache文件夹，执行flutter clean、flutter pub get等操作无效；重新克隆项目执行dart pub get后，pubspec.lock仍显示serverpod_client为0.9.20版本，怀疑是Flutter全局缓存或依赖传递导致的问题。

具体报错信息 #

Launching lib\main.dart on sdk gphone x86 in debug mode...
lib\main.dart:1
: Error: Type 'ServerpodClientErrorCallback' not found.
../…/protocol/client.dart:72
      ServerpodClientErrorCallback? errorHandler,
      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
: Error: The non-abstract class 'Consent' is missing implementations for these members:
package:ravencoin_back/…/protocol/consent_class.dart:14
 - SerializableEntity.toJson
Try to either
 - provide an implementation,
 - inherit an implementation from a superclass or mixin,
 - mark the class as abstract, or
 - provide a 'noSuchMethod' implementation.

class Consent extends SerializableEntity {
      ^^^^^^^
/C:/Users/j/AppData/Local/Pub/Cache/hosted/pub.dartlang.org/serverpod_serialization-0.9.20/lib/src/serialization.dart:21:11: Context: 'SerializableEntity.toJson' is defined here.
  dynamic toJson();
          ^^^^^^
: Error: The non-abstract class 'ConsentDocument' is missing implementations for these members:
package:ravencoin_back/…/protocol/consent_document_class.dart:14
 - SerializableEntity.toJson
Try to either
 - provide an implementation,
 - inherit an implementation from a superclass or mixin,
 - mark the class as abstract, or
 - provide a 'noSuchMethod' implementation.

解决步骤 #

1. 严格锁定版本号（移除^符号） #

^符号允许Pub拉取兼容的更新版本，直接写固定版本号可强制拉取指定版本。修改pubspec.yaml中的serverpod相关依赖：

dependencies:
  serverpod: 0.9.8
  serverpod_client: 0.9.8
  serverpod_serialization: 0.9.8
  # 其他serverpod相关依赖同步修改

2. 清理全局缓存并重新拉取依赖 #

• 清理全局Pub缓存：

  dart pub cache clean
  

• 进入项目目录，删除本地依赖缓存文件：

  rm pubspec.lock
  rm -rf .dart_tool
  

• 重新拉取依赖：

  flutter pub get
  

3. 处理依赖传递问题 #

若上述操作无效，可能是其他依赖间接引入了高版本serverpod包。执行命令查看依赖树：

flutter pub deps

找到引入高版本serverpod的依赖后，可通过以下两种方式解决：

• 给该依赖指定兼容0.9.8版本的serverpod的版本号；
• 在pubspec.yaml中添加dependency_overrides强制锁定版本：

  dependency_overrides:
    serverpod_serialization: 0.9.8
    serverpod_client: 0.9.8
  

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