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

✅ 配置步骤（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：

// 修改前
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

1. 导入项目

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

1. 关闭域名校验（重要！）

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

1. 编译运行

• 点击"编译"按钮
• 等待编译完成

---

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

1. 测试登录

• 在小程序模拟器中输入账号密码
• 账号：admin
• 密码：admin123
• 点击登录

1. 检查网络请求

• 打开调试器 → Network 标签
• 应该能看到请求发送到：http://192.168.1.100:8080/...

1. 如果登录成功

• ✅ 配置完成！

---

❌ 常见问题快速解决

问题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. 微信开发者工具中

• 点击"预览"按钮
• 扫描二维码

1. 手机连接同一WiFi

• 确保手机和电脑在同一网络

1. 如果无法访问

• 检查防火墙设置
• 尝试临时关闭防火墙

---

🔧 环境切换

开发环境（本地调试）

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

测试环境

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

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

生产环境

// 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），执行：

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

查看当前环境

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地址
- ✅ 后端能收到请求并返回数据

恭喜你，配置成功！🎉