怎么通过 Nginx 代理实现对后端接口的模拟返回-Nginx-PHP中文网

Nginx可通过return指令或alias+静态JSON文件在代理层伪造接口响应，无需后端参与；支持状态码、Header及JSON返回，适用于健康检查、配置获取等简单场景，但不支持动态计算与请求体解析。

怎么通过 nginx 代理实现对后端接口的模拟返回

可以通过 Nginx 的 return 指令或 sub_filter + 静态响应文件，结合 location 匹配规则，直接在代理层“伪造”后端接口返回，无需真实后端参与。关键在于绕过 upstream 转发，用 Nginx 自身生成响应。

使用 return 指令直接返回 JSON

适用于简单、固定结构的接口模拟（如健康检查、配置获取、空列表等）。Nginx 1.13.10+ 支持 return 返回带 body 的响应：

在对应 location 块中禁用代理，改用 return
指定 HTTP 状态码、Content-Type 头和 JSON 字符串
注意：JSON 中双引号需转义，换行可用 \n（但实际建议扁平化）

示例配置：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location /api/user/info {<br>    add_header Content-Type "application/json; charset=utf-8";<br>    return 200 '{"code":0,"data":{"id":123,"name":"mock-user"},"msg":"success"}';<br>}

用 static file + alias 返回预置 JSON 文件

适合返回较复杂、含换行/缩进或需多版本切换的响应。把 JSON 写成文件，由 Nginx 直接读取并返回：

将 JSON 文件放在 Nginx 可读路径，如 /usr/share/nginx/mock-responses/user.json
用 alias 映射请求路径到该文件（注意末尾斜杠与路径匹配逻辑）
务必设置 default_type application/json 或显式 add_header

示例配置：

location = /api/order/list {<br>    alias /usr/share/nginx/mock-responses/orders.json;<br>    add_header Content-Type "application/json; charset=utf-8";<br>    # 禁用缓存便于调试<br>    add_header Cache-Control "no-store, no-cache";<br>}

结合 map 和变量实现条件化模拟

当需要根据请求参数（如 query string）、Header 或路径片段返回不同响应时，可用 map 提前提取变量，再驱动 return 或 alias：

在 http 块中定义 map，例如提取 $arg_env 判断环境
在 location 中用 if（仅限简单判断）或直接基于 map 变量选择文件路径或响应内容
避免在 if 中使用 return 或 proxy_pass 混用，易出错；推荐用 map 控制 alias 目标

示例（按 env 参数选 mock 文件）：

http {<br>    map $arg_env $mock_file {<br>        dev     "dev.json";<br>        test    "test.json";<br>        default "base.json";<br>    }<br><br>    server {<br>        location /api/config {<br>            alias /usr/share/nginx/mock-responses/$mock_file;<br>            add_header Content-Type "application/json";<br>        }<br>    }<br>}