Django应用Apache部署时WeasyPrint生成PDF静态资源失效问题排查

看起来你遇到的问题大概率不是依赖缺失（毕竟GCP环境用相同包配置能正常运行），反而更可能是Apache服务器的权限、静态文件配置或者路径问题。下面分点帮你排查：

一、快速确认依赖是否真的没问题 #

你列出的APT包已经覆盖了WeasyPrint在Linux上的核心依赖（Cairo、Pango、GDK-Pixbuf这些都是渲染PDF必需的），GCP能正常运行也验证了这个依赖集是有效的。不过可以做个快速验证：

• 在虚拟机上直接运行命令行工具：weasyprint https://example.com test.pdf，如果能生成包含图片的PDF，说明WeasyPrint本身的依赖完全没问题，问题肯定出在Django+Apache的配置上。
• 如果命令行运行报错，再检查是否遗漏了libjpeg62-turbo或libpng16-16这类图片处理依赖，不过概率很低。

二、重点排查Apache环境的静态资源配置 #

这是最可能出问题的地方，毕竟本地和GCP的运行环境和Apache差异很大：

1. 静态文件的权限问题 #

Apache的运行用户（通常是www-data）需要有读取静态文件夹的权限：

• 先查看静态文件夹的所有者和权限：ls -ld /path/to/your/django/static
• 如果所有者不是www-data，执行：sudo chown -R www-data:www-data /path/to/your/django/static
• 同时确保文件夹权限至少是755，文件权限是644：sudo chmod -R 755 /path/to/your/django/static

2. Apache的静态文件Alias配置 #

如果WeasyPrint是通过HTTP URL访问静态资源（比如Django模板里用{% static %}生成的URL），需要确保Apache正确配置了静态文件的路由：

• 在你的Apache虚拟主机配置里，应该有类似这样的配置：

  Alias /static/ /path/to/your/django/static_root/
  <Directory /path/to/your/django/static_root/>
      Require all granted
  </Directory>
  

• 别忘了重启Apache：sudo systemctl restart apache2
• 如果不确定URL是否能访问，可以直接在浏览器里访问静态资源的URL（比如http://your-server/static/css/style.css），看是否能正常加载。

3. 改用本地文件路径而非HTTP URL #

如果通过HTTP访问静态资源有问题，可以让WeasyPrint直接读取本地文件系统的静态资源：

• 在Django视图里，获取静态文件的绝对路径，比如：

  import os
  from django.conf import settings
  from django.template.loader import render_to_string
  from weasyprint import HTML
  
  css_path = os.path.join(settings.STATIC_ROOT, 'css', 'style.css')
  html_content = render_to_string('your_template.html', context)
  pdf = HTML(string=html_content).write_pdf(stylesheets=[css_path])
  

  这样WeasyPrint不需要通过Apache的HTTP服务，直接读取本地文件，能避开很多配置问题。

4. SELinux限制（针对CentOS/RHEL系服务器） #

如果你的虚拟机用的是CentOS、RHEL这类默认开启SELinux的系统，即使文件权限正确，SELinux也可能阻止Apache读取静态文件：

• 临时关闭SELinux测试：sudo setenforce 0，然后再生成PDF试试，如果正常了，说明是SELinux的问题。
• 永久解决：给静态文件夹添加正确的SELinux上下文：sudo chcon -R system_u:object_r:httpd_sys_content_t:s0 /path/to/your/django/static

5. 确认已执行collectstatic #

如果Django配置了STATIC_ROOT，必须在虚拟机上执行：

python manage.py collectstatic

把所有APP的静态文件收集到STATIC_ROOT指定的目录，否则Apache找不到静态资源。

三、开启调试日志定位问题 #

如果上面的方法都没解决，可以开启WeasyPrint的调试日志，看看加载静态资源时的具体错误：

• 在Django视图里调用WeasyPrint时，添加日志配置：

  import logging
  logger = logging.getLogger('weasyprint')
  logger.setLevel(logging.DEBUG)
  
  # 然后执行生成PDF的代码
  

  查看日志里是否有404错误（路径不对）、权限错误（Permission Denied）等信息，能精准定位问题。

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