MBE Desktop - 故障排除指南

🔴 问题：网络连接失败（530 错误）

错误信息: "网络连接失败，请检查网络设置"
HTTP 状态码: 530
可能原因:

1. 后端 API 服务未运行
2. Cloudflare 保护（530 是 Cloudflare 错误码）
3. 网络连接问题
4. API URL 配置错误

✅ 解决方案

方案 1: 使用本地后端服务（推荐用于开发）

如果您的本地有后端服务运行在 http://localhost:8000：

1. 修改 .env 文件:

# 将 API URL 改为本地地址
VITE_API_URL=http://localhost:8000

2. 重启开发服务器:

# 停止当前运行的进程（Ctrl+C）
# 然后重新启动
npm run dev:electron

方案 2: 检查后端服务状态

检查远程后端:

# PowerShell
Invoke-WebRequest -Uri "https://mbe-dev.hi-maker.com/api/health" -Method GET

检查本地后端:

# PowerShell
Invoke-WebRequest -Uri "http://localhost:8000/api/health" -Method GET

方案 3: 启动本地后端服务

如果您有本地后端代码：

# 进入后端项目目录
cd d:\Mises\mises-behavior-engine

# 启动后端服务（根据您的启动方式）
# 例如：
python -m uvicorn src.main:app --host 0.0.0.0 --port 8000

# 或使用 docker-compose
docker-compose up

方案 4: 检查网络和代理设置

1. 检查网络连接:

   • 确认可以访问互联网
   • 检查是否有 VPN 或代理影响

2. 检查防火墙:

   • 确认防火墙未阻止连接
   • 检查本地端口 8000 是否被占用

3. 检查 DNS:

   # 测试 DNS 解析
   nslookup mbe-dev.hi-maker.com
   

🔍 调试步骤

1. 检查 API 配置

在浏览器 Console 中执行：

// 检查当前 API 配置
console.log('API Base URL:', import.meta.env.VITE_API_URL || 'https://mbe-dev.hi-maker.com')
console.log('API URL:', 'https://mbe-dev.hi-maker.com/api/v1')

2. 测试 API 连接

在浏览器 Console 中执行：

// 测试健康检查端点
fetch('https://mbe-dev.hi-maker.com/api/health')
  .then(res => {
    console.log('✅ 连接成功:', res.status)
    return res.json()
  })
  .then(data => console.log('📋 响应数据:', data))
  .catch(err => {
    console.error('❌ 连接失败:', err)
    console.log('💡 尝试本地后端: http://localhost:8000/api/health')
  })

3. 检查 Network 标签

1. 打开开发者工具（F12）
2. 切换到 Network 标签
3. 尝试注册或登录
4. 查看失败的请求：
   • 请求 URL
   • 状态码
   • 错误信息
   • 响应内容

4. 查看详细错误信息

在 Console 中查看：

• 红色错误信息
• 网络请求失败详情
• CORS 错误（如果有）

📋 常见错误码

🛠️ 快速修复命令

切换到本地后端

# Windows PowerShell
cd d:\Mises\mbe-desktop
(Get-Content .env) -replace 'VITE_API_URL=https://mbe-dev.hi-maker.com', 'VITE_API_URL=http://localhost:8000' | Set-Content .env

检查端口占用

# 检查 8000 端口是否被占用
netstat -ano | findstr :8000

重启开发服务器

# 停止当前进程（Ctrl+C）
# 然后重新启动
npm run dev:electron

📞 获取帮助

如果以上方案都无法解决问题，请提供以下信息：

1. 错误截图（Console 和 Network 标签）
2. 后端服务状态（是否运行，运行在哪个地址）
3. 网络环境（是否有代理/VPN）
4. .env 文件内容（隐藏敏感信息）

最后更新: 2026-02-08