Rust客户端发送FCGI请求时PHP无法接收请求体问题排查

针对你遇到的POST请求体无法被PHP接收的情况，从FastCGI协议规范和常见实现错误出发，重点排查以下几个核心点：

1. 必须发送FCGI_STDIN结束标记 #

FastCGI协议明确要求：当STDIN数据发送完成后，必须发送一个内容长度为0的FCGI_STDIN记录，以此告知PHP-FPM输入已结束。如果漏掉这个标记，PHP-FPM会一直等待更多输入，最终导致php://input和$_POST都为空。

示例Rust代码片段（假设你已有构建FCGI记录的工具函数）：

// 发送实际请求体数据
let stdin_data = b"foo=bar";
send_fcgi_record(stream, FCGI_STDIN, request_id, stdin_data)?;

// 发送结束标记（关键步骤！）
send_fcgi_record(stream, FCGI_STDIN, request_id, &[])?;

2. 验证CONTENT_LENGTH参数的准确性 #

确保CONTENT_LENGTH参数的值与请求体的字节数完全一致。比如"foo=bar"的字节数是7，那么CONTENT_LENGTH必须设置为字符串"7"，而非字符数或其他错误数值。如果数值不匹配，PHP会直接忽略请求体。

检查FCGI_PARAMS的设置是否正确：

// 正确示例：CONTENT_LENGTH对应实际字节数
params.insert("CONTENT_LENGTH".to_string(), "7".to_string());
params.insert("CONTENT_TYPE".to_string(), "application/x-www-form-urlencoded".to_string());

3. 检查FCGI_STDIN记录的格式正确性 #

确认你构建的FCGI_STDIN记录完全符合协议规范：

• 版本号（version）必须为1
• 类型（type）必须为FCGI_STDIN（数值常量5）
• 请求ID（requestId）必须与之前发送的FCGI_BEGIN_REQUEST记录的请求ID完全一致
• 内容长度（contentLength）字段要准确设置为请求体的字节数，填充长度（paddingLength）可设为0（非强制要求，仅当内容长度不是8的倍数时可选填充）

FCGI记录头的8字节结构：

0: version (u8)
1: type (u8)
2-3: request_id (u16, 大端字节序)
4-5: content_length (u16, 大端字节序)
6: padding_length (u8)
7: reserved (u8)

4. 确保数据发送的完整性 #

在Rust中使用TcpStream发送数据时，务必确保所有字节都已成功发送。建议使用write_all方法而非write，因为write可能只发送部分数据：

fn send_fcgi_record(stream: &mut TcpStream, record_type: u8, request_id: u16, content: &[u8]) -> std::io::Result<()> {
    let content_len = content.len() as u16;
    let header = [
        1, // 固定版本号
        record_type,
        (request_id >> 8) as u8, (request_id & 0xff) as u8,
        (content_len >> 8) as u8, (content_len & 0xff) as u8,
        0, // 填充长度设为0
        0, // 保留字段
    ];
    stream.write_all(&header)?;
    stream.write_all(content)?;
    Ok(())
}

额外验证步骤 #

• 用Wireshark抓包，对比你的Rust发送的FCGI流量与正常PHP-FPM请求（比如Nginx转发的POST请求）的差异，重点关注STDIN部分的记录格式和结束标记。
• 再次确认REQUEST_METHOD确实设置为"POST"，如果是GET请求，PHP不会解析$_POST。

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