feat(client): 网络请求重试 + 离线提示可感知重试按钮

修复①请求级重试：新增 RetryInterceptor，网络层失败重试 3 次间隔递增 1s→2s→4s；GET 全重试，写操作仅在连接未建立时重试以防重复提交。 connectTimeout 5s→8s。修复②连通性：启动首检改退避重试 4s→8s→12s，根治跨境冷启动假离线；新增检测中状态 + retry()；登录页/全局离线提示加 NetworkRetryButton，重试中转圈、结果 SnackBar 反馈。 121 个测试通过，analyze 无 error。todo #52。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-16 14:42:23 +08:00
parent 3f3aa41121
commit 018180de8c
8 changed files with 269 additions and 150 deletions
@@ -0,0 +1,65 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../core/theme/app_theme.dart';
+import '../providers/connectivity_provider.dart';
+
+/// 离线提示里的「重试」按钮：
+/// - 检测中显示转圈 +「重试中…」（过程可感知）
+/// - 重试结束用 SnackBar 反馈成功/失败（结果可感知）
+///
+/// [foreground] 适配不同底色（红色横幅用白字，琥珀框用深色）。
+class NetworkRetryButton extends ConsumerWidget {
+  final Color foreground;
+  const NetworkRetryButton({super.key, this.foreground = Colors.white});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final checking = ref.watch(connectivityCheckingProvider);
+
+    return TextButton(
+      onPressed: checking
+          ? null
+          : () async {
+              final ok =
+                  await ref.read(connectivityProvider.notifier).retry();
+              if (!context.mounted) return;
+              ScaffoldMessenger.of(context)
+                ..hideCurrentSnackBar()
+                ..showSnackBar(SnackBar(
+                  content: Text(ok ? '已重新连接服务器' : '仍无法连接服务器，请稍后重试'),
+                  backgroundColor: ok ? AppTheme.success : AppTheme.danger,
+                  duration: const Duration(seconds: 2),
+                  behavior: SnackBarBehavior.floating,
+                ));
+            },
+      style: TextButton.styleFrom(
+        foregroundColor: foreground,
+        minimumSize: const Size(0, 32),
+        padding: const EdgeInsets.symmetric(horizontal: 10),
+        tapTargetSize: MaterialTapTargetSize.shrinkWrap,
+      ),
+      child: Row(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          if (checking)
+            SizedBox(
+              width: 14,
+              height: 14,
+              child: CircularProgressIndicator(
+                strokeWidth: 2,
+                valueColor: AlwaysStoppedAnimation<Color>(foreground),
+              ),
+            )
+          else
+            Icon(Icons.refresh, size: 16, color: foreground),
+          const SizedBox(width: 6),
+          Text(
+            checking ? '重试中…' : '重试',
+            style: TextStyle(
+                color: foreground, fontSize: 13, fontWeight: FontWeight.w600),
+          ),
+        ],
+      ),
+    );
+  }
+}