旧版HTML过渡到动态系统的关键是Nginx伪静态配置，通过rewrite+try_files实现内部转发而非重定向，优先服务真实HTML文件，缺失时交由/index.php处理，并保留原始路径与查询参数。
旧版静态 HTML 文件过渡到动态系统，核心不是“替换文件”，而是让 Nginx 在用户仍访问 /about.html、/products/index.html 这类路径时，不返回 404，而是内部交由 PHP 或其他后端脚本处理，同时保持浏览器地址栏不变。这属于典型的“伪静态”场景，关键在 rewrite + try_files 的配合使用，而非重定向。
用 rewrite 把 HTML 请求转给动态入口
假设你原有 /news/2024/05/article-123.html，现在统一由 /index.php 处理，且希望保留原始路径语义（如通过 $_GET['slug'] 解析）：
- 匹配 HTML 路径并提取关键段：
rewrite ^/news/(\d{4})/(\d{2})/article-(\d+)\.html$ /index.php?year=$1&month=$2&id=$3 last; - 更通用的写法（适配所有 .html 结尾）：
rewrite ^/(.+)\.html$ /index.php?path=$1 last;这样/about.html→/index.php?path=about，后端可据此加载对应模板或内容 - 注意：必须用 last，否则不会重新匹配 location；不能用 permanent，否则暴露真实入口、破坏缓存
优先保障真实 HTML 文件仍能直接访问
过渡期常需“双轨运行”——部分页面已上线动态逻辑，其余仍为静态 HTML。这时不能一刀切 rewrite 所有 .html，而要先检查文件是否存在：
- 把静态资源规则放在前面，确保真实存在的
.html文件被直接返回：location ~ \.html$ {<br> root /var/www/html;<br> try_files $uri =404;<br>} - 再配置 fallback 规则，只捕获那些 找不到 的 HTML 请求：
location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>}这条会自动兜底所有未命中文件的请求（包括/contact.html），交给index.php处理
保留查询参数与路径语义一致性
用户可能带着参数访问旧链接，比如 /products/index.html?ref=seo，动态系统需要完整接收：
立即学习“前端免费学习笔记（深入）”；
- rewrite 中显式拼接
$query_string：rewrite ^/(.+)\.html$ /index.php?path=$1&$query_string last;（注意是 &，不是 ?，避免参数覆盖） - 或更稳妥地用 try_files + $query_string：
try_files $uri $uri/ /index.php?$query_string;Nginx 会自动把原始 ? 后面的所有内容追加到新 URL 末尾 - 后端 PHP 可通过
$_GET['path']和$_GET['ref']同时获取路径和来源参数
上线前验证与渐进收敛
不要一次性全量切换。建议分三步走：
- 先加日志记录哪些 .html 请求进了动态入口：
log_format legacy_html '$remote_addr - $request_uri → dynamic (via fallback)';<br>access_log /var/log/nginx/legacy-html.log legacy_html;
- 初期只对特定目录启用 rewrite（如
location ^~ /blog/），其余仍走静态；等流量稳定后再扩至根路径 - 监控 404 日志中是否还有大量旧 HTML 访问——若持续下降，说明前端引用或外部链接已在自然收敛
