清理废弃静态资源映射需先停用无效映射再安全删除对应文件：一、人工排查并移除废弃的root/alias配置，确认无访问及引用后整块删除；二、仅当路径不再被任何服务使用时，才通过find或分步命令清理真实文件；三、新增映射时加用途注释、统一临时路径前缀、分离资源目录并纳入部署脚本管理。
清理废弃的静态资源映射，本质不是“清 Nginx 配置”，而是**停用无效映射 + 安全删除对应文件**。Nginx 本身不管理文件生命周期，root 和 alias 都只是路径映射指令，删错配置或删错文件都可能导致 404 或服务异常。关键在两步：先断开映射关系，再清理真实文件。
一、识别并移除废弃的 root/alias 配置
废弃映射往往源于项目下线、路径重构或测试残留。需人工排查，不能依赖自动扫描：
- 检查所有站点配置文件（/etc/nginx/conf.d/*.conf、/etc/nginx/sites-enabled/），搜索 root 和 alias 关键字，重点关注注释少、路径非常规（如 /tmp/static、/var/www/old-v1）或已无对应服务的 location 块
- 确认该 location 是否仍被访问：用 nginx -t 测试语法后，临时加日志记录（access_log /var/log/nginx/old-mapping.log;），观察 24 小时内是否有请求命中
- 确认无其他配置通过 include 或 rewrite 引用该 location，避免误删导致连锁 404
- 删除或注释整段 location 块，包括其内部的 root/alias、expires、add_header 等全部指令，而非只删某一行
二、安全清理映射指向的真实目录文件
仅当确认该映射已彻底停用、且物理路径不再被其他服务（如另一个 Nginx server、Python 服务、定时任务）引用时，才可清理文件：
- 根据配置中 root 或 alias 的值，得到完整绝对路径（例如 root /var/www/legacy; → 路径为 /var/www/legacy；alias /data/uploads/; → 路径为 /data/uploads）
- 先执行 ls -la /path/to/dir 查看内容和属主，确认是否为空或仅含历史文件
- 用 find /path/to/dir -mindepth 1 -print | head -20 预览将被删除的文件列表，防止误删父级目录
- 真正清理时，推荐使用带交互提示的安全命令：
find /path/to/dir -mindepth 1 -delete（若系统支持）
或分步操作：rm -rf /path/to/dir/* && rmdir /path/to/dir（确保目录本身也废弃） - 切勿对 root 指向的顶层目录（如 /var/www）直接递归清空——它可能承载多个站点
三、防止未来映射堆积的实用习惯
废弃映射难清理，常因缺乏上下文。从源头减少问题：
- 每次新增 root/alias 映射时，在配置上方加注释，标明用途、上线时间、负责人、预期下线条件（例：# [2026-08] /admin-api-docs/ → Swagger UI for v2.3, to be removed after v3 launch）
- 对测试或临时环境，统一使用带环境标识的路径前缀（如 /staging-static/、/dev-assets/），便于批量识别和清理
- 将静态资源目录与代码仓库分离，并纳入部署脚本管理；上线新版本时，脚本自动重命名旧目录（如 static_v2.1 → static_v2.1_archive_20261002），而非直接覆盖或删除
