同版本wkhtmltox在AWS Lambda与Mac上表现不一致的问题求助

针对你遇到的Mac本地正常、Lambda环境下表格样式（外边距、td/th样式）失效的问题，以下是几个实测有效的解决方向：

• 强制提升样式优先级
  wkhtmltopdf基于Qt WebKit引擎，Lambda的Linux环境对CSS解析的优先级处理可能和Mac有差异。直接给表格相关样式添加!important，或者改用内联样式，确保样式被正确应用：

  table {
    margin: 20px !important;
    border-collapse: collapse !important;
  }
  td, th {
    padding: 8px !important;
    border: 1px solid #ddd !important;
  }
  

• 简化CSS选择器
  避免使用嵌套过深的选择器（比如.page-container .content table td），改用更直接的选择器（比如给表格加专属类.pdf-table，然后写.pdf-table td），减少环境解析时的不确定性。

• 确保Lambda层依赖完整
  wkhtmltopdf在Linux环境运行需要依赖libX11、libXext、libfontconfig等系统库，部分预构建的层可能缺失这些依赖。可以自行构建包含完整依赖的Lambda层，或者检查现有层是否包含所有必需的系统组件。

• 添加打印媒体查询
  wkhtmltopdf默认模拟打印渲染环境，把表格样式包裹在打印媒体查询中，确保样式在目标渲染模式下生效：

  @media print {
    table {
      margin: 20px;
      width: 100% !important;
    }
    td, th {
      border: 1px solid #000 !important;
      padding: 10px !important;
    }
  }
  

• 调整wkhtmltopdf参数
  在转换选项中添加以下参数，解决样式压缩或JS依赖问题：

  options = {
      # 原有参数...
      "disable-smart-shrinking": True,  # 禁用智能压缩，避免样式被篡改
      "enable-javascript": True,        # 如果CSS依赖JS动态加载（可选）
      "print-media-type": True          # 强制使用打印媒体类型（可选）
  }
  

• 检查HTML基础结构
  确保HTML文件开头包含正确的DOCTYPE声明：<!DOCTYPE html>，并将CSS直接内嵌到<head>的<style>标签中，避免外部CSS文件的路径权限问题（即使开启了enable-local-file-access，Lambda的文件系统权限仍可能影响外部资源加载）。

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