nginx不生成静态内容，仅高效分发后端动态生成并落盘的静态文件；需确保路径配置（root/alias）与生成目录严格一致，按前缀或扩展名精准分流，且文件权限、属主正确以支持热更新。
Nginx 本身不“动态生成”静态内容，它只负责高效分发已存在的文件。所谓“动态生成的静态内容”，通常指由后端应用（如 Node.js、Python Flask、Java Spring Boot）在运行时生成并写入磁盘的 HTML、JSON、SVG、预渲染页面等——这些文件物理上是静态的，但内容随业务逻辑实时更新。Nginx 的任务是把这些产出文件当作普通静态资源来服务，关键在于路径配置要与实际生成位置严格对齐。
✅ 明确生成路径与 Nginx 可访问路径的一致性
后端程序生成的文件必须落盘到 Nginx 有权限读取的目录，且路径需与 root 或 alias 配置完全匹配。
例如：
- 后端将每日报表 HTML 写入
/data/reports/2026/06/14/dashboard.html - Nginx 需能通过
http://example.com/reports/2026/06/14/dashboard.html访问该文件
这就要求：
-
location /reports/对应的 root 必须是/data（而非/data/reports） - 或使用
alias /data/reports/，让前缀/reports/被完全替换
location /reports/ {
alias /data/reports/; # 请求 /reports/xxx → 实际读 /data/reports/xxx
expires 1h;
add_header Cache-Control "public, must-revalidate";
}
⚠️ 注意：
alias结尾必须带/；root结尾不能带/（Nginx 会自动拼接）。
✅ 按扩展名或路径前缀精准分流，避免误触动态接口
用正则 location ~ 匹配常见静态产出类型，把它们从通用代理逻辑中剥离：
# 先匹配明确的静态产出路径（优先级高）
location ^~ /reports/ {
alias /data/reports/;
}
location ^~ /cache/ {
alias /var/cache/app-generated/;
}
# 再按扩展名兜底（注意顺序：正则 location 优先级低于前缀匹配，所以放后面）
location ~ \.(html|json|svg|xml|txt)$ {
root /data/generated-content;
}
这样可确保：
-
/reports/xxx.html走alias路径 -
/api/v1/data.json不被误判（因location ^~ /api/应已定义为 proxy_pass） - 单独生成的
.json文件（如/status.json）仍能被正确服务
✅ 权限与热更新支持：让 Nginx 能及时读到新内容
生成文件后，Nginx 不会自动感知变更，但以下两点决定能否立刻访问：
- 目录及文件属主需为 Nginx 工作用户（如
www-data或nginx） - 文件权限需含
r（读），目录需含r+x（读+执行，否则无法进入）
检查命令：
ls -ld /data/reports ls -l /data/reports/2026/06/14/dashboard.html
建议后端生成文件时显式设置：
chown www-data:www-data /data/reports/2026/06/14/dashboard.html chmod 644 /data/reports/2026/06/14/dashboard.html
✅ 可选：配合 try_files 支持 fallback 或缺省页
如果某些动态生成路径可能暂无文件（如报表尚未生成），可用 try_files 提供友好提示：
location /reports/ {
alias /data/reports/;
try_files $uri /reports/_empty.html =404;
}
请求 /reports/2026/06/15/dashboard.html 不存在时，返回 /data/reports/_empty.html（需真实存在）。
不复杂但容易忽略
