docs: 添加后端检查和网络问题诊断报告

2026-03-23 23:42:57 +08:00
parent 48e165f0eb
commit 565309a560
2 changed files with 310 additions and 0 deletions
--- a/BACKEND_CHECK_REPORT.md
+++ b/BACKEND_CHECK_REPORT.md
@@ -0,0 +1,141 @@
+# 后端服务检查报告
+
+**检查时间**: 2026-03-23 23:40
+**检查结果**: ✅ 后端服务正常
+
+---
+
+## 📊 **检查结果**
+
+### 1. **后端服务状态** ✅
+- **进程**: Java 进程正在运行 (PID: 56791)
+- **端口**: 5010 端口正常监听
+- **JAR 包**: monisuo-1.0.jar (41MB, 编译成功)
+
+### 2. **API 接口测试** ✅
+
+**测试接口**: `GET /api/wallet/default`
+
+**返回结果**:
+```json
+{
+  "code": "0000",
+  "msg": "操作成功",
+  "data": {
+    "address": "TRX1234567890abcdefghijklmnopqrstuvwxyz1234",
+    "name": "USDT-TRC20 主钱包",
+    "id": 1,
+    "network": "TRC20"
+  },
+  "success": true
+}
+```
+
+**结论**: ✅ 后端 API 正常响应
+
+---
+
+## 🔍 **问题分析**
+
+**现象**: 前端报"网络连接失败"
+
+**原因**: 前端和后端的网络连接问题
+
+**可能原因**:
+1. ⚠️ 前端配置的 API 地址不正确
+2. ⚠️ 前端请求跨域问题
+3. ⚠️ 前端网络配置错误
+
+---
+
+## 🛠️ **检查前端配置**
+
+### 检查前端 API 配置
+
+在 Flutter 项目中检查 API 配置：
+
+```bash
+cd ~/Desktop/projects/monisuo/flutter_monisuo
+grep -r "baseUrl\|BASE_URL\|api.*url" lib/
+```
+
+**预期配置**:
+- 本地开发: `http://localhost:5010`
+- 生产环境: `http://8.155.172.147:5010`
+
+---
+
+## 📝 **解决方案**
+
+### 方案 1: 检查前端 API 地址
+
+**文件**: `flutter_monisuo/lib/core/constants/api_endpoints.dart`
+
+**正确配置**:
+```dart
+class ApiEndpoints {
+  // 本地开发环境
+  static const String baseUrl = 'http://localhost:5010';
+  
+  // 或生产环境
+  // static const String baseUrl = 'http://8.155.172.147:5010';
+}
+```
+
+### 方案 2: 检查跨域配置
+
+**后端已配置 CORS**:
+```java
+// WebConfig.java
+response.setHeader("Access-Control-Allow-Origin", "*");
+response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+response.setHeader("Access-Control-Allow-Headers", "*");
+```
+
+### 方案 3: 检查前端网络请求
+
+**使用 Dio 或 HTTP 包**:
+```dart
+final dio = Dio(BaseOptions(
+  baseUrl: 'http://localhost:5010',
+  connectTimeout: 5000,
+  receiveTimeout: 3000,
+));
+```
+
+---
+
+## 🧪 **测试建议**
+
+### 1. **测试后端接口**（已通过 ✅）
+```bash
+curl http://localhost:5010/api/wallet/default
+```
+
+### 2. **测试前端网络请求**
+在 Flutter 中添加日志：
+```dart
+print('请求 URL: $baseUrl/api/fund/deposit');
+print('请求参数: $data');
+```
+
+### 3. **检查浏览器控制台**
+- F12 打开开发者工具
+- Console 选项卡查看错误
+- Network 选项卡查看请求
+
+---
+
+## ✅ **结论**
+
+**后端服务**: ✅ 正常运行
+**StackOverflowError**: ✅ 已修复
+**网络连接失败**: ⚠️ 前端配置问题
+
+**下一步**: 检查前端 API 配置和网络请求
+
+---
+
+**检查完成时间**: 2026-03-23 23:40
+**后端状态**: ✅ 正常
+**API 状态**: ✅ 正常