Amplify行程规划教程完成后iOS模拟器出现S3访问拒绝及登出功能缺失问题

一、StorageAccessDeniedException 问题排查与解决 #

• 验证IAM权限配置
  确认Amplify Storage模块为认证用户分配了正确的S3权限：

  • 登录Amplify控制台，进入Storage模块，检查权限设置是否允许认证用户执行s3:GetObject、s3:PutObject等操作；
  • 查看对应IAM角色的策略，确保包含针对目标S3存储桶的必要权限，避免权限范围过窄或缺失。

• 确认用户认证状态有效性
  异常大概率是因为请求S3时使用了无效的用户凭证：

  • 检查触发异常时用户是否处于已登录状态，若会话过期（比如长时间未操作），旧凭证会失效，导致S3访问被拒绝；
  • 在getImageUrl、uploadFile等涉及Storage的方法中添加异常捕获，当捕获到StorageAccessDeniedException时，提示用户重新登录。

• 核对Amplify配置文件
  检查amplifyconfiguration.dart中的Storage配置，确保存储桶名称、AWS区域与后台配置完全一致，避免因配置错误导致的请求失败。

二、添加登出与重新登录功能 #

1. 实现登出逻辑 #

在UI中添加登出按钮，点击时调用Amplify Auth的登出方法，并跳转至登录页面：

import 'package:amplify_auth_cognito/amplify_auth_cognito.dart';
import 'package:amplify_flutter/amplify_flutter.dart';
import 'package:flutter/material.dart';

Future<void> handleSignOut(BuildContext context) async {
  try {
    await Amplify.Auth.signOut();
    // 登出后跳转至登录页，替换当前路由栈
    if (mounted) {
      Navigator.pushReplacementNamed(context, '/login');
    }
  } on AuthException catch (e) {
    safePrint('登出失败: ${e.message}');
  }
}

2. 监听认证状态变化 #

通过Amplify Auth的状态流，自动监听用户登录/登出状态，及时更新UI：

@override
void initState() {
  super.initState();
  _subscribeToAuthStatus();
}

void _subscribeToAuthStatus() {
  Amplify.Auth.authStatus.listen((AuthStatus status) {
    if (status == AuthStatus.unauthenticated && mounted) {
      Navigator.pushReplacementNamed(context, '/login');
    }
  });
}

3. 会话过期自动处理 #

在API或Storage请求失败时，判断是否为认证相关错误，自动触发登出流程，避免无效凭证持续导致异常。

三、两者的关联说明 #

缺少登出重新登录功能时，用户会话过期后应用无法获取新的有效凭证，继续使用旧凭证请求S3就会触发StorageAccessDeniedException。添加登出功能后，用户可主动重新登录获取有效凭证，结合认证状态监听，能自动处理会话过期场景，从根源避免此类权限异常。

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