Azure Pipelines构建Flutter应用失败，本地编译正常求助

核心原因分析 #

你遇到的问题本质是本地与CI环境的文件系统大小写敏感性差异：

• 本地开发环境（Windows/macOS）默认大小写不敏感，即使代码导入路径和实际文件路径大小写不一致，也能正常编译；
• Azure Pipelines使用的Linux虚拟机是大小写敏感的，导入路径与实际文件路径大小写不匹配时，就会触发"文件找不到"错误，进而引发后续类型未定义、方法未定义等连锁问题。

从报错信息看，代码中导入的路径是lib/services/AppVersion/app_version_service.dart，但CI环境中该路径的文件夹/文件名大小写大概率和代码中的不一致（比如实际是app_version、appVersion而非AppVersion）。

排查与修复步骤 #

1. 验证本地文件路径的准确大小写
   在本地终端执行命令查看实际路径：

   • macOS/Linux：ls -l lib/services/
   • Windows PowerShell：Get-ChildItem lib/services/
     对比输出的文件夹名称和代码中导入语句的路径，确保大小写完全一致。

2. 统一导入路径与实际路径

   • 要么修改代码中的导入语句，使其与实际文件路径的大小写完全匹配；
   • 要么重命名文件夹/文件以匹配代码中的导入路径（注意Git对大小写变更的处理，需用git mv命令提交变更，示例：

     git mv lib/services/AppVersion lib/services/app_version
     git commit -m "Fix folder case to match import path"
     

   ）

3. 修正Pipeline中的路径问题
   你的checkout步骤指定了path: 'mobile_ui'，代码会被拉取到$(System.DefaultWorkingDirectory)/mobile_ui目录下，但后续所有Flutter任务的workingDirectory都设为$(System.DefaultWorkingDirectory)，这会导致命令执行目录错误（找不到lib文件夹）。需将所有Flutter任务的workingDirectory修改为$(System.DefaultWorkingDirectory)/mobile_ui。

4. 清理冗余的Flutter安装步骤
   你同时使用了手动下载Flutter SDK和FlutterInstall@0任务，会导致环境变量冲突。建议保留FlutterInstall@0任务，删除手动下载的步骤，简化环境配置。

调整后的Pipeline示例 #

steps:
- checkout: self
  clean: true
  persistCredentials: true
  path: 'mobile_ui'
- task: JavaToolInstaller@0
  inputs:
    versionSpec: 17
    jdkArchitectureOption: x64
    jdkSourceOption: PreInstalled
  displayName: 'Install Java 17 SDK'
- task: FlutterInstall@0
  displayName: 'Install Flutter SDK'
  inputs:
    version: custom
    customVersion: 3.3.6
- task: PowerShell@2
  displayName: "Flutter Doctor"
  inputs:
    targetType: 'inline'
    script: flutter doctor
    workingDirectory: '$(System.DefaultWorkingDirectory)/mobile_ui'
- task: PowerShell@2
  displayName: "Restore Packages"
  inputs:
    targetType: 'inline'
    script: flutter pub get
    workingDirectory: '$(System.DefaultWorkingDirectory)/mobile_ui'
- task: PowerShell@2
  continueOnError: true
  inputs:
    targetType: 'inline'
    script: 'flutter test --verbose'
    errorActionPreference: 'continue'
    workingDirectory: '$(System.DefaultWorkingDirectory)/mobile_ui'
- task: Bash@3
  displayName: 'Build Android Bundle'
  inputs:
    targetType: 'inline'
    workingDirectory: '$(System.DefaultWorkingDirectory)/mobile_ui'
    script: 'flutter build appbundle --build-name=2022.11.1 --build-number=$(Build.BuildNumber) --flavor development -t lib/main.dev.dart --verbose'

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