API开发疑问：接收PDF并同步返回结果该用GET还是POST？

1. 能不能用GET请求传递PDF文件？ #

绝对不建议这么做，核心原因如下：

• GET请求的URL存在长度限制（多数浏览器和服务器限制在2KB-8KB区间），PDF哪怕是小文件，转成URL编码后的字符串也极易超出限制，直接导致请求失败。
• 二进制PDF转成URL编码后体积会膨胀约30%，传输效率极低。
• GET参数会被记录在服务器日志、浏览器历史中，若PDF包含敏感内容，会直接造成信息泄露风险。
• 从HTTP语义和REST设计规范来看，GET是用于获取资源的请求方法，不应用来提交上传数据，违背了协议的设计初衷。

2. 使用POST请求如何返回处理结果？ #

这是标准且合理的方案，全程可以在同一次请求内完成上传与结果返回，步骤清晰：

• 客户端用multipart/form-data格式构造POST请求，将PDF文件作为表单字段上传（这是HTTP协议中文件上传的标准方式）。
• 服务器接收到文件后执行处理逻辑（比如提取文本、格式转换、内容分析等）。
• 处理完成后，直接在本次POST请求的响应中返回结果，无需额外发起请求。

简单示例 #

前端请求伪代码（JavaScript）

const formData = new FormData();
formData.append('pdf_file', document.getElementById('pdf-input').files[0]);

fetch('/api/process-pdf', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(result => {
  console.log('处理结果:', result);
});

服务器处理伪代码（Python Flask）

from flask import Flask, request, jsonify
import PyPDF2

app = Flask(__name__)

@app.route('/api/process-pdf', methods=['POST'])
def process_pdf():
    pdf_file = request.files.get('pdf_file')
    if not pdf_file:
        return jsonify({'error': '未上传PDF文件'}), 400
    
    # 示例：提取PDF文本内容
    reader = PyPDF2.PdfReader(pdf_file)
    extracted_text = ''.join([page.extract_text() for page in reader.pages])
    
    # 直接返回处理结果
    return jsonify({
        'status': 'success',
        'extracted_text': extracted_text,
        'total_pages': len(reader.pages)
    })

if __name__ == '__main__':
    app.run()

响应示例（JSON格式）

{
  "status": "success",
  "extracted_text": "PDF中的文本内容...",
  "total_pages": 5
}

如果处理结果是文件（比如优化后的PDF、转换后的图片），服务器可以直接返回文件流，设置对应的Content-Type响应头（如application/pdf），前端接收后可直接下载或预览。

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