Nginx 配置返回文本或 JSON 的方法

在 Nginx 中，你可以通过几种不同的方式配置服务器直接返回文本或 JSON 数据，而不需要依赖后端服务。以下是几种常见的方法：

1. 使用 return 指令返回文本

server {
    listen 80;
    server_name example.com;

    location /text-response {
        add_header Content-Type text/plain;
        return 200 "This is a plain text response from Nginx";
    }
}

2. 使用 echo 模块返回文本（需要安装 ngx_http_echo_module）

location /echo-text {
    default_type text/plain;
    echo "This is text from echo module";
}

3. 返回 JSON 数据

方法一：使用 return 指令

location /json-response {
    add_header Content-Type application/json;
    return 200 '{"status": "success", "message": "This is a JSON response"}';
}

方法二：使用 echo 模块

location /echo-json {
    default_type application/json;
    echo '{"status": "success", "message": "JSON from echo module"}';
}

4. 从文件中返回文本或 JSON

location /file-text {
    root /path/to/files;
    default_type text/plain;
    try_files /textfile.txt =404;
}

location /file-json {
    root /path/to/files;
    default_type application/json;
    try_files /data.json =404;
}

5. 使用 Lua 模块动态生成响应（需要安装 ngx_http_lua_module）

location /lua-json {
    default_type application/json;
    content_by_lua '
        ngx.say([[{"status": "success", "data": {"id": 123, "name": "Nginx Lua"}]])
    ';
}

注意事项

1. 对于 JSON 响应，确保设置正确的 Content-Type 头为 application/json
2. 如果返回的 JSON 中包含变量，需要确保正确转义特殊字符
3. 对于简单的静态响应，前两种方法最简单；对于复杂场景，考虑使用 Lua 模块
4. 使用 echo 模块需要额外安装，默认 Nginx 不包含此模块

完整示例配置

server {
    listen 80;
    server_name api.example.com;

    # 返回纯文本
    location /status {
        add_header Content-Type text/plain;
        return 200 "Service is running";
    }

    # 返回静态JSON
    location /api/health {
        add_header Content-Type application/json;
        return 200 '{"status": "healthy", "timestamp": "$time_iso8601"}';
    }

    # 从文件返回JSON
    location /api/config {
        root /var/www/json;
        default_type application/json;
        try_files /config.json =404;
    }

    # 使用Lua返回动态JSON
    location /api/dynamic {
        default_type application/json;
        content_by_lua '
            local time = ngx.localtime()
            ngx.say(string.format([[{"server_time": "%s", "request_id": "%s"}]], 
                   time, ngx.var.request_id))
        ';
    }
}

以上配置可以根据你的具体需求进行调整和组合使用。