微信本地开发调试指南

# 微信本地开发调试指南

## 方案一：微信公众平台测试号（推荐）

### 1. 申请测试号
访问：https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
微信扫码登录后，获得测试号的 appId 和 appSecret

### 2. 配置测试号
测试号优势：
- 无需域名验证
- 功能与正式号基本一致
- 可以测试授权登录、消息推送、自定义菜单等

### 3. 配置授权回调域名
在测试号管理页面，配置「网页授权域名」为你的内网穿透地址

---

## 方案二：内网穿透工具

### 使用 ngrok
```bash
# 安装 ngrok
brew install ngrok  # macOS
# 或下载: https://ngrok.com/download

# 启动穿透（假设本地服务在5000端口）
ngrok http 5000

# 会得到一个公网地址，如：
# https://xxxx-xxx-xxx-xxx.ngrok-free.app
```

### 使用 cloudflare tunnel（免费）
```bash
# 安装 cloudflared
brew install cloudflare/cloudflare/cloudflared

# 启动穿透
cloudflared tunnel --url http://localhost:5000

# 会得到一个公网地址
```

### 使用 localtunnel（免费，无需注册）
```bash
# 安装
npm install -g localtunnel

# 启动穿透
lt --port 5000

# 会得到一个公网地址，如：
# https://xxx-xxx-xxx.loca.lt
```

---

## 方案三：微信开发者工具

### 1. 下载微信开发者工具
https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

### 2. 使用公众号网页调试
- 打开开发者工具
- 选择「公众号网页调试」
- 输入页面地址进行调试

---

## 当前项目配置说明

如果使用测试号，需要修改以下配置：

1. 更新数据库中的 appId 和 appSecret
2. 或修改环境变量 WECHAT_APP_ID 和 WECHAT_APP_SECRET
3. 配置授权回调域名为内网穿透地址

### 配置文件位置
- 环境变量: `.env.local`
- 数据库配置表: `system_settings`（category = 'wechat'）

---

*文档创建时间：2026-02-25*