Streamlit部署依赖问题：如何处理wkhtmltopdf的安装需求

能不能把wkhtmltopdf纳入requirements.txt？ #

明确说不行。requirements.txt是pip用来管理Python包的配置文件，而wkhtmltopdf是系统级二进制工具，不属于Python包生态，pip根本没法通过它安装这个工具。

适配Streamlit的可行部署方案 #

1. Buildpack方案（完全适配Streamlit） #

主流PaaS平台（比如Heroku、Render）都支持buildpack，你可以用多buildpack组合：

• 先添加Python buildpack，用来处理你的Python依赖和Streamlit项目的运行环境
• 再添加专门的wkhtmltopdf buildpack（这类buildpack会针对平台的系统环境自动安装对应的wkhtmltopdf二进制包）
• 部署流程中，平台会先完成系统级依赖的安装，再处理Python包，pdfkit就能正常找到wkhtmltopdf的执行路径

2. 自定义安装脚本 #

如果是自建服务器或者支持自定义启动脚本的平台：

• 写一个setup.sh脚本，包含系统级安装命令，比如针对Ubuntu/Debian环境：

  sudo apt-get update && sudo apt-get install -y wkhtmltopdf
  

• 部署时先执行这个脚本，再启动Streamlit服务（比如streamlit run your_app.py）

3. Docker容器化部署（最稳定的方案） #

用Docker可以彻底消除本地和部署环境的依赖差异，给你个简单的Dockerfile示例：

FROM python:3.9-slim

# 安装wkhtmltopdf系统依赖
RUN apt-get update && apt-get install -y wkhtmltopdf

WORKDIR /app

# 安装Python依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制项目代码
COPY . .

EXPOSE 8501

# 启动Streamlit应用
CMD ["streamlit", "run", "app.py"]

不管你把容器部署到什么平台，这个镜像都能保证所有依赖到位，Streamlit和pdfkit都能正常运行。

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