在 RAG 知识库项目中排查依赖 Milvus 的服务启动失败，以下是完整排查过程。
宿主机重启（或容器崩溃）后，一组服务没有自动恢复，应用端口无监听、docker ps -a 里容器全是 Exited。根因是 docker-compose.yml 没配 restart 策略（默认 no），容器挂了就永远躺着。解法：给所有生产服务加 restart: always，让基础设施在崩溃或重启后自愈。
在为客户维护一台 2 核 7G 的云服务器时，发现磁盘使用率 93%（仅剩 3G），Airflow scheduler 持续占用 160% CPU。以下是完整的诊断和修复过程。
WSL2 + Docker Desktop 有两个常见的网络坑：
localhost:5432 连到的是容器内的 PostgreSQL 而非远程服务器——密码没错，连的实例错了network_mode: host 共享的是 Docker 工具 VM 网络，不是 WSL2 网络——curl localhost:8080 失败在为客户搭建 AI 数据分析平台（Airflow + PostgreSQL）的本地开发环境时遇到此问题，记录根因与解法。
Docker Desktop for Windows (WSL2 backend) 下，network_mode: host 的容器端口无法从 WSL2 宿主机访问。容器内 ss 显示端口在监听，但宿主机 curl localhost:PORT connection refused。原因是 host 模式共享的是 Docker 内部工具 VM 的网络，不是 WSL2 的网络。解法：override 文件中用 network_mode: !reset 移除 host 模式，改用 bridge + external network + 端口映射。
在为客户开发 WordPress Block Theme 时反复遇到这五个问题，每次排查都花了不少时间。整理成指南，帮助同样在做 FSE 开发的同学快速定位。
五个问题按频率排序：文件修改不生效（数据库缓存覆盖文件）、块嵌套错乱（注释未关闭）、子主题内容不渲染（缺少 post-content 块）、SVG 图标消失（WP_Filesystem 被插件污染）、WP-CLI 邮件失败（SMTP 插件在命令行不生效）。每个场景都给出可直接复用的排查命令。
在为客户部署 WordPress 站点时遇到此问题，记录根因与解法。
镜像 Dockerfile 中的 VOLUME 声明会创建匿名卷，挂载优先级高于 docker-compose.yml 的 bind mount。解决方案：停止容器 → 删除匿名卷 → 重启。
官方 WordPress Docker 镜像不含 WP-CLI。在 docker-compose.yml 中添加 command 配置，容器启动时自动下载安装 WP-CLI，无需手动进入容器操作。