Django模型方法调用subprocess执行无头Chrome截图异常排查

以下是针对你遇到的问题的具体排查方向和解决办法：

1. 运行环境的权限与上下文差异 #

命令行和Django Shell以当前登录用户身份运行，而Django模型的render方法通常在Web服务器进程（如uwsgi、gunicorn）下执行，运行用户可能是nginx、www-data或自定义的受限用户。这类用户可能：

• 没有执行google-chrome-unstable的权限
• 没有截图保存目录的读写权限
• 无法访问Chrome运行所需的临时目录

排查步骤：

• 查看Web服务器进程的运行用户：ps aux | grep uwsgi（替换为你的服务器进程名）
• 切换到该用户，手动执行你的Chrome截图命令，观察是否能成功生成正常截图：su - nginx -s /bin/bash，然后执行命令

解决办法：

• 给Web服务器用户添加Chrome二进制文件的执行权限：chmod o+x /path/to/google-chrome-unstable
• 确保截图保存目录对该用户有读写权限：chown -R nginx:nginx /path/to/save/screenshots
• 在Chrome命令中指定可访问的临时目录：添加--user-data-dir=/tmp/chrome-web-user，并确保该目录权限为755

2. 无头Chrome参数不全（尤其是沙箱与证书忽略相关） #

在非桌面环境（如Web服务器进程）下，无头Chrome需要额外的参数才能正常运行，而命令行环境可能默认绕过了这些限制：

• 缺少--no-sandbox和--disable-setuid-sandbox：受限用户通常无法使用Chrome的沙箱机制，会导致Chrome静默启动失败，生成空截图
• 证书忽略参数不足：仅--ignore-certificate-errors可能不够，需补充--ignore-ssl-errors、--allow-insecure-localhost（针对本地自签名证书）

修正后的命令示例：

google-chrome-unstable --headless=new --ignore-certificate-errors --ignore-ssl-errors --allow-insecure-localhost --no-sandbox --disable-setuid-sandbox --screenshot=/path/to/result.png https://your-self-signed-domain.com

3. 未捕获Chrome的错误输出 #

你提到无证书错误输出，大概率是因为在subprocess调用中没有捕获stderr，Chrome的真实错误被隐藏了（比如沙箱启动失败、资源加载失败等）。

修改代码捕获错误：

import subprocess
import logging

def render_screenshot():
    cmd = [
        "google-chrome-unstable",
        "--headless=new",
        "--ignore-certificate-errors",
        "--no-sandbox",
        "--disable-setuid-sandbox",
        "--screenshot=/path/to/screenshot.png",
        "https://your-target-url"
    ]
    result = subprocess.run(cmd, capture_output=True, text=True)
    # 将错误日志写入Django日志
    if result.stderr:
        logging.error(f"Chrome screenshot error: {result.stderr}")
    return result.returncode

查看Django的日志文件，就能得到Chrome的具体报错信息，定位问题更精准。

4. 页面加载超时或资源访问限制 #

Web服务器进程的网络上下文可能与命令行不同：

• 目标页面的自签名证书图片URL可能无法被Web服务器进程访问（比如是本地内网地址，服务器进程没有对应网络权限）
• 无头Chrome默认的加载时间较短，导致图片还没加载完成就生成了截图

解决办法：

• 添加加载等待参数：--wait-for-network-idle（等待网络空闲后再截图）或--timeout=60000（设置60秒超时）
• 用Web服务器用户测试访问图片URL：su - nginx -s /bin/bash，然后执行curl -k https://your-image-url，确认能正常获取图片内容

5. 资源限制导致Chrome无法正常运行 #

Web服务器进程可能有ulimit资源限制（如最大打开文件数、内存限制），导致Chrome无法启动或加载资源。

排查步骤：

• 查看Web服务器进程的ulimit设置：cat /proc/$(pidof uwsgi)/limits（替换为你的进程名）
• 对比命令行用户的ulimit：ulimit -a

解决办法：

• 在Web服务器的配置文件中（如uwsgi.ini）添加资源限制配置，例如：

  limit-as = 2048
  rlimit-nofile = 65535
  

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