Django生产环境Windows服务器下LaTeX生成PDF返回非零退出状态1求解

问题解决步骤 #

1. 检查pdflatex运行环境与权限 #

• 确认服务器已安装完整TeX发行版（推荐TeX Live，兼容性比MiKTeX更好，无交互安装弹窗问题），安装时选择「所有用户可用」选项，安装完成后将pdflatex所在目录（通常是TeX安装路径下的bin目录）添加到系统级PATH环境变量，配置完成后重启IIS/Apache服务，确保服务进程能读取到最新环境变量。
• 给两个目录配置对应运行用户的读写执行权限：
  • 系统临时目录C:\Windows\TEMP
  • 项目中配置的自定义临时目录FILE_UPLOAD_TEMP_DIR
    IIS的运行用户为对应应用池的IIS AppPool\你的应用池名称，Apache的运行用户为SYSTEM或配置的自定义服务用户。

2. 抓取具体报错日志定位问题 #

当前报错只返回退出码1，无具体错误信息，是因为pdflatex使用了batchmode参数屏蔽了输出，按以下操作获取日志：

• 临时修改django_tex的调用参数，将-interaction=batchmode替换为-interaction=nonstopmode
• 或修改render_to_pdf逻辑，运行后不删除临时目录，到报错信息中给出的临时目录（比如C:\Windows\TEMP\tmpzrdfals9）下找到texput.log文件，日志中会明确标注错误原因，比如缺包、字符编码错误、模板语法错误等。

3. 修复常见模板与配置问题 #

根据大量同类场景的报错统计，大概率是以下问题之一：

• 字符编码适配问题：你模板中存在大量葡萄牙语重音字符，Windows下pdflatex默认编码适配较差，可在LaTeX模板头部新增两行配置：

  \usepackage[T1]{fontenc}
  \usepackage[brazil]{babel}
  

• 临时目录配置问题：你当前settings中只配置了FILE_UPLOAD_TEMP_DIR，django_tex默认仍使用系统临时目录，可在settings.py中新增配置强制使用自定义临时目录，方便权限管理：

  LATEX_TMP_DIR = os.path.join(BASE_DIR,'temp')
  

• 缺LaTeX依赖包：你模板用到的anysize、fancyhdr包在服务器TeX环境中未安装，可手动安装对应包，若使用MiKTeX需要提前开启「无需确认自动安装缺失包」选项，避免服务运行时无交互界面导致安装失败报错。

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