📝 企业微信应用本地调试完全指南企业微信应用本地调试通常需要将企业微信配置域名映射到本机，并通过本地代理将请求转发到

企业微信应用本地调试通常需要将企业微信配置域名映射到本机，并通过本地代理将请求转发到开发环境或本地服务。本文将从 hosts 配置、Nginx 代理、调试流程等方面，给出完整可复用的本地调试方案。

1. 背景与目标

为了在本地调试，我们需要做到：

将企业微信已配置的域名映射到本机 127.0.0.1
通过 Nginx 或类似代理把该域名请求转发到本地开发服务
保持企业微信请求路径与本地服务路径一致

2. 修改本机 hosts 文件

将企业微信在回调域名配置的域名映射到本机地址。以 urm.mkmmll.com 为例：

127.0.0.1 urm.mkmmll.com

2.1 macOS / Linux

编辑 /etc/hosts，加入以上一行。

2.2 Windows

编辑 C:\Windows\System32\drivers\etc\hosts，加入相同内容。

3. 安装 Nginx

本地调试推荐使用 Nginx 做反向代理。macOS 上可用 Homebrew 安装：

brew install nginx

如果你已经有 Nginx，可以直接修改现有配置。

4. 配置 Nginx 反向代理

将企业微信请求的域名代理到本地服务或开发环境地址。假设企业微信回调地址是：

https://urm.mkmmll.com/app-h5/pageIndex

我们希望把 /app-h5/* 转发到本地服务，例如 http://127.0.0.1:9010/。

4.1 基本配置

在 Nginx 配置文件中添加一个 server 块：

server {
    listen 80;
    server_name urm.mkmmll.com;

    location /app-h5/ {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        rewrite ^/app-h5/(.*)$ /$1 break;
        proxy_pass http://127.0.0.1:9010/;
    }
}

4.2 如果本地服务不是 `/app-h5` 根路径

例如本地服务实际路径是 /pageIndex，可以保持请求路径一致：

location /app-h5/ {
    rewrite ^/app-h5/(.*)$ /$1 break;
    proxy_pass http://127.0.0.1:9010/;
}

如果你的本地服务已经在 http://127.0.0.1:9010/app-h5/ 下工作，则可以直接使用：

location /app-h5/ {
    proxy_pass http://127.0.0.1:9010/;
}

5. 本地调试流程

确认企业微信后台的回调域名已配置为 urm.mkmmll.com。
修改本机 hosts，将 urm.mkmmll.com 指向 127.0.0.1。
启动本地服务，例如 npm run dev 或 yarn dev。
启动 Nginx，并加载上述代理配置。
访问 http://urm.mkmmll.com/app-h5/pageIndex（或 https://urm.mkmmll.com/app-h5/pageIndex）。
检查 Nginx 日志和本地服务日志，确认请求已经命中并正确转发。

--

6. 总结

企业微信应用本地调试的核心在于：

让企业微信访问的域名指向本机
用 Nginx 代理请求到本地服务

完成上述三步后，就可以在本地环境中稳定调试企业微信应用。祝你调试顺利。

📝 企业微信应用本地调试完全指南