Flutter pub upgrade提示依赖约束冲突但无显式约束问题排查

问题现象 #

执行flutter pub upgrade时提示存在7个包有新版本，但因依赖约束无法升级；然而执行flutter pub outdated却显示所有依赖均为最新：

forest@forestg$ flutter pub upgrade
Resolving dependencies... (1.1s)
Downloading packages... 
  csslib 0.17.3 (1.0.0 available)
  leak_tracker 10.0.4 (10.0.5 available)
  leak_tracker_flutter_testing 3.0.3 (3.0.5 available)
  material_color_utilities 0.8.0 (0.11.1 available)
  meta 1.12.0 (1.15.0 available)
  test_api 0.7.0 (0.7.1 available)
  vm_service 14.2.1 (14.2.2 available)
No dependencies changed.
7 packages have newer versions incompatible with dependency constraints.
Try `flutter pub outdated` for more information.

forest@forestg$ flutter pub outdated
Showing outdated packages.
[*] indicates versions that are not the latest available.

Package Name  Current  Upgradable  Resolvable  Latest  

direct dependencies: all up-to-date.

dev_dependencies: all up-to-date.
all dependencies are up-to-date.
forest@forestg:$ 

项目pubspec.yaml配置 #

name: workout_generator_x
description: A randomized workout generator
publish_to: 'none'

version: 1.0.0+1

environment:
  sdk: '>=3.0.5 <4.0.0'
  flutter: ">=2.2.0"

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2
  flutter_localizations:
    sdk: flutter
  json_annotation: ^4.8.1
  provider: ^6.0.5
  flutter_html: 3.0.0-beta.2
  path_provider: ^2.0.15
  flutter_svg: ^2.0.7
  auto_size_text: ^3.0.0
  intl: ^0.19.0
  url_launcher: ^6.1.12
  shared_preferences: ^2.2.0
  rename_app: ^1.3.1
  file_picker: ^8.0.3
  just_audio: ^0.9.15
  google_mobile_ads: ^5.1.0

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_launcher_icons: "^0.13.1"


  flutter_lints: ^4.0.0

flutter:
  uses-material-design: true
  assets:
    - assets/lang/
    - assets/flags/
    - assets/app_database/
    - assets/icons/svg/
    - assets/images/
    - assets/beeps/

flutter_launcher_icons:
  android: "launcher_icon"
  ios: true
  image_path: "assets/icons/app_icon.png"
  min_sdk_android: 21 # android min sdk min:16, default 21
  web:
    generate: true
    image_path: "assets/icons/app_icon.png"
    background_color: "#hexcode"
    theme_color: "#hexcode"
  windows:
    generate: true
    image_path: "assets/icons/app_icon.png"
    icon_size: 48 # min:48, max:256, default: 48
  macos:
    generate: true
    image_path: "assets/icons/app_icon.png"

已尝试操作 #

• 执行flutter clean
• 使用flutter pub upgrade --major-version升级

当前环境信息 #

forest@forestg$ flutter --version
Flutter 3.22.1 • channel stable • https://github.com/flutter/flutter.git
Framework • revision a14f74ff3a (5 days ago) • 2024-05-22 11:08:21 -0500
Engine • revision 55eae6864b
Tools • Dart 3.4.1 • DevTools 2.34.3

forest@forestg$ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.22.1, on Ubuntu 22.04.3 LTS 6.5.0-35-generic, locale en_US.UTF-8)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Chrome - develop for the web
[✓] Linux toolchain - develop for Linux desktop
[✓] Android Studio (version 2022.2)
[✓] IntelliJ IDEA Ultimate Edition (version 2024.1)
[✓] IntelliJ IDEA Ultimate Edition (version 2023.3)
[✓] VS Code (version 1.85.1)
[✓] Connected device (3 available)
[✓] Network resources

• No issues found!

解决方案 #

1. 明确问题根源 #

提示的7个包是间接依赖（由项目直接依赖包引入），flutter pub outdated默认仅展示直接依赖，因此看不到这些包的更新信息。这些间接依赖无法升级，是因为直接依赖的版本约束限制了它们的版本范围。

2. 定位间接依赖的来源 #

执行以下命令查看间接依赖的引用链，确认哪些直接依赖约束了旧版包：

flutter pub deps --tree

比如csslib大概率是flutter_html的依赖，当前使用的flutter_html: 3.0.0-beta.2版本较旧，对csslib的版本约束较低。

3. 升级直接依赖包 #

优先升级那些约束了旧版间接依赖的直接包：

• flutter_html: 从beta版升级到最新稳定版（如^3.0.0或更高）
• just_audio: 升级到最新稳定版（如^0.9.36）
• google_mobile_ads: 升级到最新稳定版（如^5.1.0之后的版本）
• 其他直接依赖如provider、file_picker等也可检查新版本并升级

4. 更新环境约束 #

匹配当前Flutter版本，修改environment字段：

environment:
  sdk: '>=3.4.0 <4.0.0'
  flutter: ">=3.22.0"

5. 重新执行依赖更新 #

修改完成后依次执行：

flutter pub get
flutter pub upgrade

6. 强制覆盖间接依赖（谨慎使用） #

如果某些直接依赖暂时无法升级，可通过dependency_overrides强制升级间接依赖，但需注意可能引发兼容性问题，升级后需全面测试：

dependency_overrides:
  csslib: ^1.0.0
  leak_tracker: ^10.0.5
  leak_tracker_flutter_testing: ^3.0.5
  material_color_utilities: ^0.11.1
  meta: ^1.15.0
  test_api: ^0.7.1
  vm_service: ^14.2.2

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