Azure Function通过HttpResponse返回PyPDF2生成PDF报500错误

开发Python版Azure Function实现以下逻辑：将用户数据写入PDF指定表单字段，处理完成后将PDF作为响应返回给客户端。函数本地运行全流程无异常，部署到Azure环境后始终返回500错误码。

原有__init__.py实现代码如下：

import logging

import azure.functions as func
from PyPDF2 import PdfFileReader, PdfFileWriter


def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('----- Python HTTP trigger function processed a request. -----')

    BLOB_NAME = 'sheet.pdf'

    reader = PdfFileReader(BLOB_NAME)
    writer = PdfFileWriter()

    page = reader.pages[0]

    writer.addPage(page)

    sheetData = {}
    sheetData["Full Name"] = "Name"

    writer.updatePageFormFieldValues(writer.getPage(0), sheetData)

    return func.HttpResponse(writer, mimetype="application/pdf")

已完成初步排查：

• 将返回值替换为str(writer.getPage(0))等字符串类型内容时可正常返回，确认requirements.txt依赖配置无误
• 仅当HttpResponse返回非字符串类型响应体时触发失败，尝试配置正确mimetype后问题仍复现，无法定位根因

Azure Functions Python运行时对HttpResponse的响应体类型有严格校验，仅支持字符串、字节流、可迭代字节块类型的内容。直接传入的PdfFileWriter是自定义类实例，不属于上述合法响应体类型，云端运行时无法将其序列化为HTTP响应内容，因此抛出500内部错误。
本地运行正常是因为本地Azure Functions Core Tools的worker版本校验逻辑更宽松，存在隐式类型转换的容错逻辑，但这种转换并不会生成合法的PDF二进制内容，实际本地返回的内容也不是可正常打开的PDF文件。

• 引入Python标准库io模块创建内存字节缓冲区，无需生成本地临时文件
• 将PdfFileWriter生成的PDF内容写入缓冲区，提取纯二进制格式的PDF字节数据
• 将二进制PDF数据作为响应体传入HttpResponse，同时补充正确的响应头支持下载/预览

修复后的完整代码：

import logging
import io
import azure.functions as func
from PyPDF2 import PdfFileReader, PdfFileWriter


def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('----- Python HTTP trigger function processed a request. -----')

    BLOB_NAME = 'sheet.pdf'

    reader = PdfFileReader(BLOB_NAME)
    writer = PdfFileWriter()

    page = reader.pages[0]
    writer.addPage(page)

    sheetData = {}
    sheetData["Full Name"] = "Name"
    writer.updatePageFormFieldValues(writer.getPage(0), sheetData)

    # 写入内存缓冲区并提取二进制PDF内容
    pdf_buffer = io.BytesIO()
    writer.write(pdf_buffer)
    pdf_buffer.seek(0)
    pdf_content = pdf_buffer.getvalue()

    # 配置响应头，将attachment改为inline即可支持浏览器内预览
    resp_headers = {
        "Content-Disposition": "attachment; filename=filled_sheet.pdf"
    }

    return func.HttpResponse(
        body=pdf_content,
        mimetype="application/pdf",
        headers=resp_headers
    )

补充说明：如果部署后出现PDF表单字段填充不生效的问题，可检查云端安装的PyPDF2版本，PyPDF2 3.x+版本调整了部分表单处理API，也可以替换为官方继任维护的pypdf库获得更稳定的表单处理能力。

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