wkhtmltopdf部署服务器后PDF页脚不显示，本地正常求排查

结合你描述的现象（本地正常、服务器异常，且临时页脚文件已生成并内容正确），以下是几个常见的问题点及对应的解决方法：

1. 临时文件权限问题 #

服务器上生成的临时文件可能因权限设置，导致wkhtmltopdf进程无法读取。默认ioutil.TempFile创建的文件权限是0600（仅创建者可读），如果你的应用程序和wkhtmltopdf运行在不同用户下（比如应用以www-data运行，wkhtmltopdf以其他用户运行），就会出现权限不足的情况。

解决方法：
在生成临时文件后，修改其权限为其他用户可读取：

// Save the rendered HTML to a temporary file
tmpFile, err := ioutil.TempFile("", "footer-*.html")
if err != nil {
    return "", err
}
// 修改文件权限为0644，允许其他用户读取
if err := os.Chmod(tmpFile.Name(), 0644); err != nil {
    tmpFile.Close()
    os.Remove(tmpFile.Name())
    return "", err
}

2. 文件路径协议问题 #

部分服务器环境下的wkhtmltopdf版本，要求本地文件路径必须加上file://前缀才能正确识别。

解决方法：
设置FooterHTML时添加协议前缀：

page.FooterHTML.Set("file://" + footerFilePath)

注意：Linux服务器下路径格式为file:///tmp/xxx.html，Windows服务器需调整为file:///C:/path/to/footer.html。

3. wkhtmltopdf版本差异 #

本地与服务器上的wkhtmltopdf版本不一致，可能存在兼容性问题。比如旧版本对页脚HTML的加载逻辑有bug。

解决方法：

• 执行wkhtmltopdf --version查看本地版本
• 在服务器上安装相同版本的wkhtmltopdf，或升级到0.12.6及以上的稳定版本

4. 服务器临时目录限制 #

部分服务器会对/tmp目录做特殊配置（比如自动清理、挂载为tmpfs且空间不足），导致wkhtmltopdf读取文件时，文件已被清理或无法访问。

解决方法：

• 避免使用系统临时目录，改为在应用程序的专属目录下生成临时文件：

// 替换TempFile的第一个参数为应用可写的专属目录，比如"./app-tmp"
tmpFile, err := ioutil.TempFile("./app-tmp", "footer-*.html")

• 确保该专属目录存在且应用有读写权限

5. 页脚渲染环境问题 #

服务器上的wkhtmltopdf可能因缺少字体、CSS样式未生效等渲染环境问题，导致页脚被隐藏或布局错乱。

解决方法：

• 检查footer.html中的CSS样式，确保页脚元素有足够高度，且无display: none或visibility: hidden属性
• 确认服务器上安装了页脚中使用的字体，避免因字体缺失导致布局异常

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