nginx整合静态资源需按路径前缀精准映射：用location+alias实现安全映射，避免root拼接错误；支持多环境map变量、版本化^~匹配、反向代理中服务级前缀隔离，禁用兜底/static/。
用 Nginx 整合不同来源的静态资源，核心是让请求路径与物理目录精准对应，同时避免路径拼接错误、缓存冲突和跨服务资源错乱。不靠猜，靠明确映射。
按路径前缀分发到不同目录
最常用也最稳妥的方式：为每个资源来源分配独立 URL 前缀（如 /images/、/vendor/、/admin/），再用 location + alias 映射到各自真实路径。
-
alias 更安全：它会直接替换匹配的 location 路径段。例如
location /images/ { alias /data/assets/images/; }，请求/images/logo.png就落到/data/assets/images/logo.png - 别用
root处理带前缀的路径：比如location /images/ { root /data/assets/; }，实际会拼成/data/assets/images/images/logo.png，多了一层images - 多个前缀可并存：只要 location 块互不重叠，Nginx 按最长前缀匹配，互不影响
按域名或请求头动态路由
当同一套配置要服务多个环境（如 dev.example.com、staging.example.com），可用 map 提前定义变量，再在 location 中复用。
- 在
http块里写：map $host $env_root { dev.example.com "/var/www/dev"; staging.example.com "/var/www/staging"; default "/var/www/prod"; } - 在
server块中：location /static/ { alias $env_root/static/; }或location / { root $env_root; } - 所有分支必须覆盖，否则未匹配时变量为空，导致 404
版本化资源共存（如 /v1/、/v2/）
前端构建输出带版本前缀的资源（如 CRA 设 "homepage": "/v2/"），后端 API 同理。Nginx 只需做路径到目录的硬映射。
- 用
^~匹配确保优先级：location ^~ /v2/ { alias /var/www/app-v2/; } - 每个版本目录物理隔离，缓存也天然隔离——浏览器和 CDN 都以完整 URL 为缓存键，
/v1/app.js和/v2/app.js完全无关 - 配合符号链接更新（如
/var/www/app-latest → /var/www/app-v2），上线零停机，旧版本缓存仍有效
反向代理中静态资源不串源
多个后端服务共用一个域名时（如 /api/ 转 5000 端口，/numberLimit/ 转 5001 端口），它们各自的 /static/ 不能都走根路径，否则会全部落到主服务。
- 修改后端模板，让静态资源路径带上服务前缀：Flask 中用
url_for('static', _external=False)不够，应设STATIC_URL_PREFIX="/numberLimit/static"，生成/numberLimit/static/css/style.css - Nginx 对应配置：
location ^~ /numberLimit/static/ { alias /var/www/numberLimit/static/; }，或转发给对应后端：location ^~ /numberLimit/static/ { proxy_pass http://127.0.0.1:5001/static/; } - 禁止把
/static/放在兜底location /里，否则所有服务的静态请求都会被错误捕获
