如何让Python C API通过FastCGI将输出发送至NGINX而非stdout？

核心原因 #

Python的print默认输出到系统原生stdout，但FastCGI环境中，响应内容需要通过FCGI提供的FCGI_stdout流发送，两者不属于同一文件描述符，导致Python的输出被丢弃，无法进入FastCGI响应。

解决方案 #

方式一：重定向Python的sys.stdout到FCGI输出流 #

通过Python C API修改sys.stdout，让Python的输出直接写入FastCGI的响应流：

#include <Python.h>
#include <string.h>
#include <fcgi_stdio.h>

int main() {
    Py_Initialize();

    // 获取sys模块并替换stdout为FCGI输出流
    PyObject *sys_module = PyImport_ImportModule("sys");
    PyObject *fcgi_stdout = PyFile_FromFile(FCGI_stdout, "w", "w", NULL);
    PyObject_SetAttrString(sys_module, "stdout", fcgi_stdout);

    // 释放Python对象引用
    Py_XDECREF(fcgi_stdout);
    Py_XDECREF(sys_module);

    while (FCGI_Accept() >= 0) {
        printf("Content-type: text/plain\r\n\r\n");
        PyRun_SimpleString("print('hey')");
        // 强制刷新FCGI输出流，确保内容即时发送
        FCGI_fflush(FCGI_stdout);
    }

    Py_Finalize();
    return 0;
}

方式二：捕获Python输出到缓冲区再手动输出 #

如果不想修改全局sys.stdout，可以将Python输出捕获到字符串缓冲区，再通过FCGI接口输出：

#include <Python.h>
#include <string.h>
#include <fcgi_stdio.h>

int main() {
    Py_Initialize();

    // 初始化字符串缓冲区作为Python stdout
    PyObject *sys_module = PyImport_ImportModule("sys");
    PyObject *io_module = PyImport_ImportModule("io");
    PyObject *string_io = PyObject_CallMethod(io_module, "StringIO", NULL);
    PyObject_SetAttrString(sys_module, "stdout", string_io);

    // 初始化阶段释放引用
    Py_XDECREF(string_io);
    Py_XDECREF(io_module);
    Py_XDECREF(sys_module);

    while (FCGI_Accept() >= 0) {
        printf("Content-type: text/plain\r\n\r\n");
        
        PyRun_SimpleString("print('hey')");
        
        // 读取缓冲区内容并输出
        PyObject *sys_module = PyImport_ImportModule("sys");
        PyObject *stdout_attr = PyObject_GetAttrString(sys_module, "stdout");
        PyObject *output = PyObject_CallMethod(stdout_attr, "getvalue", NULL);
        
        if (PyUnicode_Check(output)) {
            const char *str = PyUnicode_AsUTF8(output);
            FCGI_printf("%s", str);
        }
        
        // 重置缓冲区，供下一次请求使用
        PyObject_CallMethod(stdout_attr, "seek", "(i)", 0);
        PyObject_CallMethod(stdout_attr, "truncate", NULL);
        
        // 释放当前请求相关的Python对象引用
        Py_XDECREF(output);
        Py_XDECREF(stdout_attr);
        Py_XDECREF(sys_module);
        
        FCGI_fflush(FCGI_stdout);
    }

    Py_Finalize();
    return 0;
}

额外注意事项 #

• 编译时需链接Python和FastCGI库，示例命令：gcc -o fcgi-python fcgi-python.c -lpython3.10 -lfcgi（根据实际Python版本、库名调整）
• 确保FastCGI套接字文件（/tmp/sock-fcgi.sock）权限正确，NGINX进程有权限访问
• 每次请求后必须调用FCGI_fflush，避免内容滞留缓冲区无法发送

内容的提问来源于stack exchange，提问作者Sidney