# 微信小程序本地调试 - 快速配置清单

## ✅ 配置步骤（5分钟完成）

### 第1步：查找电脑IP地址（1分钟）

**Windows系统**：
```bash
# 打开命令提示符（Win+R，输入cmd）
ipconfig

# 找到这一行：
IPv4 地址 . . . . . . . . . . . . : 192.168.1.100
                                    ↑↑↑↑↑↑↑↑↑↑↑↑↑↑
                                    记下这个IP地址
```

**Mac系统**：
```bash
# 打开终端
ifconfig

# 找到 en0 或 en1 下的 inet 地址
inet 192.168.1.100
     ↑↑↑↑↑↑↑↑↑↑↑↑↑↑
     记下这个IP地址
```

---

### 第2步：修改配置文件（30秒）

打开文件：`app/config.js`

找到第6行，修改为你的IP：

```javascript
// 修改前
const LOCAL_IP = 'localhost'

// 修改后（填入你刚才记下的IP）
const LOCAL_IP = '192.168.1.100'  // ⚠️ 改成你的IP
```

保存文件。

---

### 第3步：启动后端服务（1分钟）

**方法1：使用IDEA**
- 打开项目 `RuoYi-Vue-master`
- 找到 `ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java`
- 点击运行按钮 ▶️
- 等待启动完成，看到 `Application Run Successfully`

**方法2：命令行**
```bash
cd d:\project\急救转运\code\Api\RuoYi-Vue-master
mvn spring-boot:run
```

**验证后端是否启动**：
- 浏览器打开：http://localhost:8080
- 应该看到若依系统的登录页面

---

### 第4步：配置微信开发者工具（2分钟）

1. **打开微信开发者工具**
   - 如果没有安装，下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

2. **导入项目**
   - 点击"+"号 → 导入项目
   - 目录：`d:\project\急救转运\code\Api\RuoYi-Vue-master\app`
   - AppID：使用测试号（或填入你的AppID）
   - 项目名称：急救转运调度系统

3. **关闭域名校验**（重要！）
   - 点击右上角"详情"
   - 切换到"本地设置"标签
   - ✅ 勾选"不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书"

4. **编译运行**
   - 点击"编译"按钮
   - 等待编译完成

---

### 第5步：测试验证（1分钟）

1. **测试登录**
   - 在小程序模拟器中输入账号密码
   - 账号：`admin`
   - 密码：`admin123`
   - 点击登录

2. **检查网络请求**
   - 打开调试器 → Network 标签
   - 应该能看到请求发送到：`http://192.168.1.100:8080/...`

3. **如果登录成功**
   - ✅ 配置完成！

---

## ❌ 常见问题快速解决

### 问题1：request:fail -104

**原因**：后端没有启动或IP错误

**解决**：
```bash
# 1. 检查后端是否运行
浏览器打开: http://192.168.1.100:8080

# 2. 如果打不开，检查IP是否正确
再次执行: ipconfig

# 3. 确保端口8080没有被占用
netstat -ano | findstr 8080
```

---

### 问题2：request:fail url not in domain list

**原因**：没有关闭域名校验

**解决**：
- 微信开发者工具 → 详情 → 本地设置
- ✅ 勾选"不校验合法域名..."

---

### 问题3：真机调试无法访问

**原因**：手机和电脑不在同一WiFi

**解决**：
1. 确保手机和电脑连接同一WiFi
2. 检查电脑防火墙是否阻止了8080端口
3. 临时关闭防火墙测试：
   ```bash
   # Windows（管理员权限）
   netsh advfirewall set allprofiles state off
   
   # 测试完成后记得打开
   netsh advfirewall set allprofiles state on
   ```

---

## 📱 真机调试配置

### 真机预览

1. **微信开发者工具中**
   - 点击"预览"按钮
   - 扫描二维码

2. **手机连接同一WiFi**
   - 确保手机和电脑在同一网络

3. **如果无法访问**
   - 检查防火墙设置
   - 尝试临时关闭防火墙

---

## 🔧 环境切换

### 开发环境（本地调试）

```javascript
// app/config.js
const CURRENT_ENV = 'development'  // 使用本地IP
```

### 测试环境

```javascript
// app/config.js
const CURRENT_ENV = 'test'  // 使用测试服务器
```

需要先在第13-16行配置测试服务器地址：
```javascript
test: {
  baseUrl: 'http://test.yourdomain.com',  // 改为实际地址
  description: '测试环境'
}
```

### 生产环境

```javascript
// app/config.js
const CURRENT_ENV = 'production'  // 使用线上服务器
```

需要先在第17-20行配置生产服务器地址：
```javascript
production: {
  baseUrl: 'https://api.yourdomain.com',  // 改为实际地址
  description: '生产环境'
}
```

---

## 📋 配置检查清单

开始调试前，请确认：

- [ ] 后端服务已启动（http://localhost:8080 可以访问）
- [ ] 已查到电脑IP地址
- [ ] config.js 中已填写正确的IP地址
- [ ] 微信开发者工具已安装
- [ ] 已关闭域名校验
- [ ] 手机和电脑在同一WiFi（真机调试时）

---

## 💡 提示

### 查看当前配置

在小程序中打开控制台（Console），执行：

```javascript
console.log(getApp().globalData.config.baseUrl)
// 应该输出: http://192.168.1.100:8080
```

### 查看当前环境

```javascript
const config = getApp().globalData.config
console.log('环境:', config.appInfo.envDescription)
console.log('接口:', config.baseUrl)
```

---

## 📞 需要帮助？

如果按照以上步骤仍无法解决，请提供：

1. 错误截图（控制台 Console 和 Network）
2. 配置文件内容（config.js）
3. 后端启动日志
4. 电脑IP地址

---

## ✅ 配置成功标志

当你看到：
- ✅ 小程序能正常登录
- ✅ Network中能看到请求发送到你的IP地址
- ✅ 后端能收到请求并返回数据

恭喜你，配置成功！🎉