GitHub Action中django-compressor无法识别{% compress %}压缩块

排查步骤与解决方案 #

1. 确认模板加载路径配置 #

GitHub Action环境中，Django的TEMPLATES配置可能未正确包含目标模板目录。检查settings.py里的TEMPLATES设置，确保DIRS包含模板所在路径，或者APP_DIRS设为True且你的应用已加入INSTALLED_APPS：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],  # 确认路径与实际模板位置匹配
        'APP_DIRS': True,
        'OPTIONS': {
            # 其他配置项
        },
    },
]

2. 调整命令执行顺序 #

离线压缩依赖已收集完成的静态文件，GitHub Action中必须先执行静态文件收集，再运行压缩命令，同时加上--force强制重新生成压缩文件：

- name: 收集静态文件
  run: python manage.py collectstatic --noinput
- name: 执行离线压缩
  run: python manage.py compress --force

3. 保证环境配置与本地一致 #

确保GitHub Action中的关键配置和本地完全相同，可通过环境变量传入：

- name: 执行离线压缩
  env:
    DEBUG: "False"
    COMPRESS_ENABLED: "True"
    COMPRESS_OFFLINE: "True"
    COMPRESS_ROOT: "${{ github.workspace }}/static_collected"
    STATIC_ROOT: "${{ github.workspace }}/static_collected"
  run: python manage.py compress --force

重点确认COMPRESS_ROOT和STATIC_ROOT指向同一目录，避免压缩文件生成路径错误。

4. 检查模板压缩块语法 #

确认模板内的{% compress %}块无语法错误，比如正确闭合标签、使用对应类型（CSS/JS），且块内无动态生成的静态文件路径（离线压缩无法解析动态变量）：

{% compress css %}
<link rel="stylesheet" href="{% static 'css/base.css' %}">
<link rel="stylesheet" href="{% static 'css/layout.css' %}">
{% endcompress %}

5. 查看详细压缩日志 #

在GitHub Action中运行压缩命令时添加-v参数，获取详细日志排查模板加载或静态文件缺失问题：

- name: 执行带日志的离线压缩
  run: python manage.py compress -v --force

根据日志提示定位具体问题，比如某静态文件未被收集、模板解析报错等。

6. 清理缓存残留 #

GitHub Action的缓存可能残留旧文件，执行压缩前清理压缩缓存目录：

- name: 清理压缩缓存
  run: rm -rf static_collected/CACHE/*

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