Flask应用本地docx转PDF正常，IIS部署后PDF生成失败

核心问题排查方向 #

你的问题核心是IIS环境下DOCX转PDF失败，但本地运行完全正常，结合代码和部署场景，主要从以下几个维度排查解决：

1. PDF转换依赖的环境缺失 #

你代码里的convert函数大概率依赖python-docx2pdf库，这个库在Windows环境下需要依赖Microsoft Office（Word）或LibreOffice才能完成转换：

• 本地运行时，你的个人用户账户能正常启动Office/LibreOffice，但IIS的应用池是用系统账户（比如IUSR、ApplicationPoolIdentity）运行的，这类账户默认没有权限启动桌面应用（Office需要桌面交互权限）。
• 解决办法：
  • 若用Office：给应用池账户添加允许本地登录权限，同时在Office设置中关闭“受保护的视图”，确保Office是完整安装版本（非便携版）。
  • 更推荐用LibreOffice：安装后在代码里明确指定LibreOffice的执行路径，避免环境变量解析问题：

    from docx2pdf import convert
    # 替换为你的LibreOffice实际安装路径
    convert(pdf_input_path, pdf_output_path, libreoffice_path=r"C:\Program Files\LibreOffice\program\soffice.exe")
    

  • 注意：要给应用池账户开放LibreOffice安装目录及临时缓存目录的读写权限。

2. IIS应用池权限不足 #

DOCX能正常生成说明文件写入权限没问题，但PDF转换过程中可能需要访问系统临时目录（比如Office的临时文件夹、LibreOffice缓存），而IIS账户默认没有这些目录的读写权限：

• 解决办法：
  • 给应用池账户（格式为IIS AppPool\[你的应用池名称]）添加以下目录的读写权限：
    • 你的Flask应用files目录（再次确认权限）
    • Windows系统临时目录C:\Windows\Temp
    • Office/LibreOffice的安装目录及缓存目录
• 另外，不要用线程异步处理转换：IIS的FastCGI进程会在请求结束后快速回收，后台线程可能还没完成转换就被强制终止。把线程调用改成同步执行：

  # 替换线程代码，直接同步调用
  CreateApplication('LPG application General.docx', project_describtion, serialnumber)
  

3. 相对路径解析陷阱 #

本地运行时相对路径基于项目根目录，但IIS部署后，进程的当前工作目录可能不是你的项目根目录，导致convert函数找不到生成好的DOCX文件：

• 解决办法：用绝对路径替代所有相对路径，确保路径解析不依赖当前工作目录：

  # 获取项目根目录的绝对路径
  BASE_DIR = os.path.dirname(os.path.abspath(__file__))
  docx_output_path = os.path.join(BASE_DIR, f'files/{serialnum}/MainFiles/Application{serialnum}.docx')
  

4. 日志捕获具体错误 #

在代码里添加异常捕获和日志输出，直接定位转换失败的具体原因：

def CreateApplication(file, replacements, serialnum):
    BASE_DIR = os.path.dirname(os.path.abspath(__file__))
    try:
        # 原有的DOCX生成代码...
        
        docx_output_path = os.path.join(BASE_DIR, f'files/{serialnum}/MainFiles/Application{serialnum}.docx')
        pdf_output_path = os.path.splitext(docx_output_path)[0] + '.pdf'
        
        convert(docx_output_path, pdf_output_path)
        print(f"PDF生成成功：{pdf_output_path}")
    except Exception as e:
        error_msg = f"{datetime.now()}: PDF转换失败 - {str(e)}"
        print(error_msg)
        # 写入本地日志文件方便排查
        with open(os.path.join(BASE_DIR, 'pdf_convert_error.log'), 'a', encoding='utf-8') as f:
            f.write(error_msg + '\n')

查看日志就能明确是权限不足、依赖缺失还是路径错误。

快速解决步骤 #

1. 移除异步线程调用，改成同步执行转换逻辑。
2. 确认PDF转换依赖的Office/LibreOffice已正确安装，且应用池账户有访问权限。
3. 把所有文件路径替换为绝对路径。
4. 添加异常日志，定位具体错误后针对性修复。

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