使用eb CLI部署Flask至Elastic Beanstalk时.venv未被.ebignore忽略的问题

问题原因分析 #

1. .ebignore规则匹配不完整：如果你的.ebignore只写了.venv而未添加递归忽略规则，eb CLI可能仅忽略.venv目录本身，漏掉了残留的lib64软链接/子目录。虚拟环境的lib64通常是指向lib的软链接，部分打包工具对软链接的忽略逻辑和普通目录不同。
2. 本地虚拟环境残留文件：删除.venv时可能未彻底清理，lib64作为软链接或空目录残留，导致eb CLI打包时将其纳入部署包。
3. git缓存干扰：如果git仓库曾追踪过.venv目录，即便后来添加了忽略规则，git缓存的文件仍可能被eb CLI打包（eb CLI默认包含git已追踪文件，除非被.ebignore明确排除）。

AWS缓存不是问题——删除应用和环境后，新创建的环境会从新上传的部署包初始化，不会保留旧资源的缓存。

解决步骤 #

1. 修复.ebignore规则 #

确保.ebignore放在项目根目录，包含递归忽略.venv的完整规则：

.venv/
.venv/**

这会强制忽略.venv目录下所有内容，包括软链接和子目录。

2. 彻底清理本地残留 #

执行命令彻底删除本地.venv目录，避免残留文件：

rm -rf .venv

若需本地开发，重新创建虚拟环境：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. 强制生成干净的部署包 #

部署时使用--staged参数，确保只打包符合规则的文件：

eb deploy --staged

也可先本地生成部署包检查内容：

eb bundle --output deploy.zip

解压deploy.zip确认.venv目录完全不存在后，再部署到EB。

4. 清理git缓存（若用git管理） #

如果git曾追踪过.venv，执行以下命令移除缓存：

git rm -r --cached .venv
git commit -m "Stop tracking .venv directory"

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