Flutter项目使用AWS Amplify运行报错：awsconfiguration.json文件缺失如何解决

报错核心原因 #

你遇到的报错由两个常见问题导致：

1. 已添加Amplify Analytics插件但未完成对应Pinpoint资源的配置推送，amplifyconfiguration.json中缺失pinpointAnalytics字段
2. 安卓项目缺少资源存放目录，对应配置文件无法被正确读取

解决步骤 #

• 首先确认Analytics插件配置完整
  执行amplify add analytics按指引完成Pinpoint项目配置后，重新执行amplify push，此时根目录下的amplifyconfiguration.json会自动生成pinpointAnalytics相关配置字段
• 补全安卓端目录与配置文件
  • 如果使用Amplify Flutter v1.0及以上版本，框架不再依赖awsconfiguration.json，仅需要amplifyconfiguration.json即可：
    1. 手动在./app/src/main/res路径下创建全小写命名的raw文件夹
    2. 将项目根目录自动生成的amplifyconfiguration.json拷贝到该raw文件夹中
  • 如果使用v0.x旧版本Amplify，执行amplify console打开控制台手动导出awsconfiguration.json文件，放入上述raw目录即可
• 验证配置结构
  打开amplifyconfiguration.json确认存在以下结构：

  "analytics": {
      "plugins": {
          "awsPinpointAnalyticsPlugin": {
              "pinpointAnalytics": {
                  "appId": "你的Pinpoint应用ID",
                  "region": "你的资源部署区域"
              },
              "pinpointTargeting": {
                  "region": "你的资源部署区域"
              }
          }
      }
  }
  

• 清理重构
  执行flutter clean清理项目缓存后重新运行应用，报错即可解决

替代方案 #

如果你不需要使用Analytics功能，直接在Amplify初始化代码中移除Analytics插件的添加逻辑，不需要额外配置即可跳过该报错。

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