Django使用LaTeX渲染PDF时lualatex返回非零退出状态127报错

在Django项目中需要使用LaTeX渲染生成PDF，预期实现点击按钮同时完成表单保存、LaTeX格式PDF生成的功能，运行过程中触发报错。

核心报错信息 #

Command 'lualatex -interaction=batchmode  texput.tex' returned non-zero exit status 127.

项目相关代码与配置 #

views.py 业务代码 #

@login_required
def forms_render_pdf_view(request, *args, **kwargs):
  if request.user.is_authenticated:
   if request.method == 'POST':
         form = ReportForm(request.POST, )
         form.instance.user=request.user
         if form.is_valid():
            form.save()
            obj_Formulaire = Loads.objects.filter(user=request.user).last()
            field_obj_load_between_posts = Loads._meta.get_field('load_between_posts')
            field_value_load_between_posts = field_obj_load_between_posts.value_from_object(obj_Formulaire)  
            load_between_posts = field_value_load_between_posts
            if load_between_posts == True:
                field_obj_custom_load = Loads._meta.get_field('custom_load')
                field_value_custom_load = field_obj_custom_load.value_from_object(obj_Formulaire)  
                qh = float(field_value_custom_load)
            else:
                qh = float(0)
            context = { 
                    'qh': qh,
                }
            template_name = 'pages/test.tex'
            context = {'qh': qh}
            return render_to_pdf(request, template_name, context, filename='test.pdf')
   form = ReportForm()
   context = {'form': form}
   return render(request, 'pages/form_gelander_report.html',  context)

settings.py 配置片段 #

TEMPLATES = [
    {   'NAME': 'tex',
  }

INSTALLED_APPS = [
    'django_tex',
]

错误回溯片段 #

in django_tex/core.py, line 37, in run_tex_in_directory
            stderr=PIPE,
            check=True,
            cwd=directory,
        )
    except CalledProcessError as called_process_error:
        try:
            with open(
                os.path.join(directory, "texput.log"), "r", encoding="utf-8" …
            ) as f:
                log = f.read()
        except FileNotFoundError:
            raise called_process_error
        else:
            raise TexError(log=log, source=source, template_name=template_name)

前置操作 #

已通过命令pip install django_tex安装django_tex库，暂无法定位报错触发原因，需要可行的排查思路与解决方案。

*exit status 127是操作系统返回的「命令不存在」错误，说明当前Django进程根本找不到lualatex可执行文件，还未进入LaTeX编译流程，按以下顺序排查即可：

• 安装LuaLaTeX编译环境
  django_tex只是连接Django和LaTeX编译链的封装库，本身不携带LaTeX编译器，必须在运行Django的系统中安装完整的TeX发行版：
  • Windows环境：安装TeX Live或MiKTeX，安装时勾选LuaTeX组件，安装完成后将TeX安装目录下的bin文件夹路径加入系统PATH环境变量
  • macOS环境：安装MacTeX，安装完成后在终端执行which lualatex，能输出路径则为正常
  • Linux（Ubuntu/Debian系为例）：执行sudo apt update && sudo apt install texlive-luatex texlive-latex-extra安装基础编译组件与常用宏包
    验证方式：在启动Django服务的同一个终端下执行lualatex --version，正常输出版本号即说明环境配置正确。如果是用gunicorn、systemd、docker部署的场景，需要确认运行Django进程的用户能读取到包含lualatex的PATH变量，避免服务运行时环境变量和终端用户环境变量不一致。
• 修正settings.py中不完整的模板配置
  当前TEMPLATES配置仅填写了NAME字段，缺少django_tex要求的必填参数，且注意不要覆盖Django默认的HTML模板配置，完整配置参考：

  TEMPLATES = [
      # 保留原有Django默认HTML模板引擎配置，不要删除
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [],
          'APP_DIRS': True,
          'OPTIONS': {
              'context_processors': [
                  'django.template.context_processors.debug',
                  'django.template.context_processors.request',
                  'django.contrib.auth.context_processors.auth',
                  'django.contrib.messages.context_processors.messages',
              ],
          },
      },
      # 新增django_tex的TeX模板引擎配置
      {
          'NAME': 'tex',
          'BACKEND': 'django_tex.engine.TeXEngine',
          'APP_DIRS': True,
      }
  ]
  

• 确认临时目录权限
  django_tex运行时会在系统临时目录（默认是/tmp）生成tex源文件、日志、中间编译文件，需要确认运行Django进程的用户对临时目录有读写、执行权限，避免权限不足导致命令调用失败。
• 后续编译错误排查
  等lualatex命令可以被正常调用后，如果仍有报错，直接读取django_tex抛出的异常中携带的texput.log内容，根据日志提示修正tex模板语法、安装缺失的LaTeX宏包即可。

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