Appflow中构建Ionic Capacitor 3应用提示Capacitor配置命令失败怎么解决

错误表现 #

构建时Fastlane抛出错误：Capacitor config command failed, ensure capacitor dependency has been updated to version 3 or more，即使本地已经升级Capacitor到3.x版本依然报错。

完整错误日志：

[18:58:02]: fastlane finished with errors
/usr/local/bundle/bin/fastlane: [!] Capacitor config command failed, ensure capacitor dependency has been updated to version 3 or more (RuntimeError)
/usr/local/bundle/gems/fastlane-2.179.0/fastlane_core/lib/fastlane_core/ui/interface.rb:153:in `shell_error!': Shell command exited with exit status 1 instead of 0. (FastlaneCore::Interface::FastlaneShellError)
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane_core/lib/fastlane_core/ui/ui.rb:17:in `method_missing'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/helper/sh_helper.rb:80:in `sh_control_output'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/helper/sh_helper.rb:12:in `sh'
    from /builds/NathanAllmeida/apvs-associate/fastlane/actions/create_capacitor_config.rb:13:in `run'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:263:in `block (2 levels) in execute_action'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/actions/actions_helper.rb:69:in `execute_action'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:255:in `block in execute_action'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:229:in `chdir'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:229:in `execute_action'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:157:in `trigger_action_by_name'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/fast_file.rb:159:in `method_missing'
    from Fastfile:162:in `block (2 levels) in parsing_binding'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/lane.rb:33:in `call'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:49:in `block in execute'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:45:in `chdir'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/runner.rb:45:in `execute'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/lane_manager.rb:47:in `cruise_lane'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/command_line_handler.rb:36:in `handle'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/commands_generator.rb:108:in `block (2 levels) in run'
    from /usr/local/bundle/gems/commander-fastlane-4.4.6/lib/commander/command.rb:178:in `call'
    from /usr/local/bundle/gems/commander-fastlane-4.4.6/lib/commander/command.rb:153:in `run'
    from /usr/local/bundle/gems/commander-fastlane-4.4.6/lib/commander/runner.rb:476:in `run_active_command'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane_core/lib/fastlane_core/ui/fastlane_runner.rb:76:in `run!'
    from /usr/local/bundle/gems/commander-fastlane-4.4.6/lib/commander/delegates.rb:15:in `run!'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/commands_generator.rb:352:in `run'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/commands_generator.rb:41:in `start'
    from /usr/local/bundle/gems/fastlane-2.179.0/fastlane/lib/fastlane/cli_tools_distributor.rb:122:in `take_off'
    from /usr/local/bundle/gems/fastlane-2.179.0/bin/fastlane:23:in `<top (required)>'
    from /usr/local/bundle/bin/fastlane:23:in `load'
    from /usr/local/bundle/bin/fastlane:23:in `<main>'
Running after script...
$ run "clean-up"

修复步骤 #

• 统一所有Capacitor相关依赖版本：确保package.json中所有@capacitor/开头的依赖（包含core、cli、ios、android等）版本均为3.x，不存在2.x与3.x混装的情况，修改后删除node_modules目录重新执行npm install安装依赖。
• 校验Capacitor配置文件：确认项目根目录存在合法的capacitor.config.json或capacitor.config.ts文件，从2.x升级的项目需要按照3.x规范调整配置结构，本地执行npx cap init可以生成符合要求的默认配置文件。
• 调整Appflow构建栈：日志中使用的Fastlane 2.179.0对Capacitor 3适配存在缺陷，在Appflow控制台将构建栈切换到Node.js 16及以上的新版本镜像，适配Capacitor 3的运行要求。
• 指定正确的项目路径：如果是monorepo项目或者package.json不在仓库根目录，需要在Appflow构建配置中指定Capacitor项目的根目录，避免Fastlane无法识别到已安装的Capacitor依赖。
• 本地预校验：本地执行npx cap config list命令，确认命令可以正常输出配置信息，解决本地运行时的所有报错后再提交代码到Appflow构建。

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