Flask应用集成pypandoc部署到IIS服务器出现500错误如何解决

第一步：先获取具体错误信息 #

500属于通用服务错误，必须先拿到具体报错内容才能定位根因，操作如下：

• 调整Flask代码，给接口增加异常捕获，直接返回错误详情，也可以同步写入本地日志文件方便后续排查：

@app.route("/")
def home():
    try:
        note = "<p>测试HTML内容</p>"
        rtf_string = pypandoc.convert_text(note, 'rtf', format='html')
        return rtf_string
    except Exception as e:
        return f"具体错误：{str(e)}", 500

• 开启IIS详细错误输出：在IIS管理器对应站点的「错误页」设置中，选择「编辑功能设置」，勾选「详细错误」；同时修改站点根目录的web.config配置，允许错误详情返回到客户端。

第二步：修正代码导入顺序错误 #

你当前的代码存在环境变量设置顺序错误的问题：先导入pypandoc再设置PYPANDOC_PANDOC环境变量，但pypandoc在导入阶段就会尝试查找pandoc路径，此时你设置的环境变量并未生效。调整代码顺序如下：

from flask import Flask  
import os
# 先设置环境变量，再导入pypandoc
os.environ.setdefault('PYPANDOC_PANDOC','C:\\Pandoc\\pandoc.exe')
import pypandoc

app = Flask(__name__)

@app.route("/")  
def home():  
    note = "<p>任意HTML字符串</p>"
    rtf_string = pypandoc.convert_text(note, 'rtf', format='html')  
    return rtf_string  

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

第三步：排查IIS进程权限问题 #

IIS的应用程序池默认使用权限极低的专用账号运行，权限不足是这类问题最常见的原因：

• 检查Pandoc目录权限：右键C:\Pandoc文件夹，选择「安全」-「编辑」-「添加」，查找你站点对应的应用程序池标识（格式为IIS AppPool\你的应用池名称，查找位置要选择本地计算机），给该账号授予「读取和执行」、「列出文件夹内容」权限。
• 检查临时目录权限：pandoc转格式时会在系统临时目录（默认C:\Windows\Temp）生成临时文件，给上述应用池标识授予该目录的「读取」、「写入」权限。
• 快速验证权限问题：打开IIS应用池的高级设置，把「标识」临时改为「LocalSystem」，重启应用池后测试接口，如果恢复正常则可确认是权限问题，验证完成后改回原标识调整权限即可，不要长期使用LocalSystem运行，存在安全风险。

第四步：排查临时目录适配问题 #

如果系统临时目录权限调整后依然报错，可以手动指定pandoc使用的专用临时目录：

# 先手动创建一个专用临时目录，比如C:\PandocTemp，提前给应用池标识开通读写权限
os.environ.setdefault('TEMP', 'C:\\PandocTemp')
os.environ.setdefault('TMP', 'C:\\PandocTemp')
# 再设置pandoc路径、导入pypandoc
os.environ.setdefault('PYPANDOC_PANDOC','C:\\Pandoc\\pandoc.exe')
import pypandoc

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