setup:static-content:deploy 长时间停在 frontend/Magento/blank，终端没有新输出不一定代表死锁。它可能在压缩大量文件、等待子进程、发生内存换页，或某个主题继承/语言包文件让编译器反复处理。不要在生产发布窗口盲目 Ctrl+C，先看进程是否仍有进展。

一分钟内判断进程状态

ps -eo pid,ppid,etime,%cpu,%mem,stat,cmd | grep '[s]etup:static-content:deploy'
pgrep -P 12345 -a
pidstat -p 12345 5 6
df -h
df -i
free -m

CPU 持续有占用、输出目录文件数在增长，通常只是慢；进程状态 D 且磁盘 I/O 等待高，查存储；进程 S、无子进程、日志和文件长时间不变，才更像等待或锁。

观察输出是否推进

watch -n 5 'find pub/static/frontend/Magento/blank -type f 2>/dev/null | wc -l'
du -sh pub/static var/view_preprocessed 2>/dev/null
tail -f /tmp/static-deploy.log

下次执行把 stdout 和 stderr 同时保存：

php -d memory_limit=-1 bin/magento setup:static-content:deploy -f -vvv \
  2>&1 | tee /tmp/static-deploy.log

memory_limit=-1 只适合有容器/系统内存限制和监控的维护环境，不是长期默认。若主机开始大量 swap，取消无限内存并减少并行度。

按 area、theme、locale 隔离失败组合

php bin/magento setup:static-content:deploy -f en_US \
  --area frontend --theme Magento/blank -vvv

php bin/magento setup:static-content:deploy -f zh_CN \
  --area frontend --theme Vendor/theme -vvv

Blank 成功、自定义主题失败，检查主题继承、LESS 变量与 requirejs 配置；en_US 成功、zh_CN 失败，检查语言包文件编码和翻译 CSV。一次只测一个组合比全量部署更容易定位。

搜索编译器异常和循环引用

grep -n -Ei 'error|exception|fatal|memory|permission' /tmp/static-deploy.log
find app/design app/code -name '*.less' -o -name 'requirejs-config.js'
grep -R --line-number '@import' app/design/frontend/Vendor/theme/web/css/source 2>/dev/null

自定义 LESS 的循环 import、巨大 source map、不可读文件或损坏软链接都可能表现为某主题长时间不动。使用 namei -l 检查路径权限，不要全局 chmod 777。

安全中止与重新开始

确认进程无 I/O、无子任务且已超出基线时间后，先发送 TERM 并等待清理，不直接 kill -9。重新部署前只删除已确认属于目标 area/theme/locale 的输出与预处理目录；构建型发布最好在独立构建机生成产物，再原子切换到 Web 节点。

并行部署卡住时检查子进程和文件描述符

使用并行策略后，父进程可能在等待一个失败但未正常回收的子进程。记录父子 PID、打开文件数量和系统限制：

PARENT=12345
pstree -ap "$PARENT"
for p in "$PARENT" $(pgrep -P "$PARENT"); do
  printf '%s ' "$p"; ls /proc/$p/fd 2>/dev/null | wc -l
done
ulimit -n
cat /proc/$PARENT/limits | grep -i 'open files'

若日志出现 Too many open files，先确认是主题文件数量、进程泄漏还是系统限制过低，再调整构建环境。只提高 ulimit 而不查泄漏，下一次更大的部署仍会卡住。

确认构建目录没有被其他发布同时修改

lsof +D pub/static/frontend/Magento/blank 2>/dev/null | head -n 50
ps -ef | grep -E '[s]etup:static-content:deploy|[d]eploy' 
find pub/static -maxdepth 2 -name deployed_version.txt -print -exec cat {} \;

两套流水线同时删除和生成 pub/static 会出现“本进程一直有输出但目标文件反复消失”的假卡死。发布系统应使用互斥锁或构建版本目录，完成后一次性切换软链接。

验收时比较部署命令退出码、目标文件数量、首页和结账关键 JS/CSS 的 HTTP 200，并从所有 Web 节点各取一次静态版本。部署“跑完”但节点版本不一致仍会产生随机 404。