伪静态规则未生效主因是服务器未执行规则，非语法错误：Apache需启用mod_rewrite、AllowOverride All；Nginx需将rewrite置于location内或用try_files兜底，并重载配置验证。
伪静态规则没生效，Nginx/Apache返回真实404而非重写
伪静态配置后首页能打开、其他页面全404，大概率是规则压根没被服务器执行——不是写错了，而是模块没启用或配置位置不对。
Apache必须确认mod_rewrite已启用：a2enmod rewrite（Debian/Ubuntu）或检查httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so是否取消注释。.htaccess文件还要确保AllowOverride All在对应<directory></directory>块里，否则规则被忽略。
Nginx常见问题是把rewrite写在了location /之外，或漏掉try_files兜底。正确做法是在location /里加：try_files $uri $uri/ /index.html;（SPA常用），或用rewrite ^/post/(\d+)$ /post.php?id=$1 last;这类显式重写，且必须放在server块内、location之前。
- 改完配置后，Apache要
sudo systemctl reload apache2，Nginx要sudo nginx -t && sudo systemctl reload nginx - 别只看浏览器效果，用
curl -I http://localhost/post/123看响应头是否为HTTP/1.1 200 OK，而不是404 Not Found - Apache错误日志默认在
/var/log/apache2/error.log，搜rewrite或not found能直接看到规则是否被读取
.htaccess或nginx.conf路径写错，导致重写目标文件找不到
伪静态把/article/123重写成/article.php?id=123，但article.php实际在/src/article.php，或者压根不存在——这时服务器会按最终路径去找文件，找不到就真返回404。
立即学习“前端免费学习笔记（深入）”；
关键点：重写后的路径是相对于DocumentRoot的，不是相对于.htaccess所在目录。比如DocumentRoot是/var/www/html，而你的article.php放在/var/www/html/blog/article.php，那重写目标就得是/blog/article.php?id=123，不能写成/article.php。
- Apache下用
RewriteLog（旧版）或LogLevel alert rewrite:trace3（新版）开启重写调试，日志里会打印每一步匹配和替换结果 - Nginx用
error_log /var/log/nginx/rewrite.log notice;配合rewrite_log on;，再tail -f /var/log/nginx/rewrite.log实时观察 - 临时把重写目标改成一个肯定存在的文件（如
/index.html），确认规则能触发，再逐步还原到真实目标
伪静态后CSS/JS/图片也404，说明资源路径没适配重写逻辑
页面HTML能加载，但控制台一堆GET http://localhost/css/style.css 404，这不是伪静态本身的问题，而是前端资源引用路径和服务器路由不一致。
典型场景：你用try_files $uri $uri/ /index.html;做SPA路由，但HTML里写了<link rel="stylesheet" href="css/style.css">。当访问/user/profile时，浏览器会尝试请求/user/css/style.css（相对路径），而服务器按规则去/user/下找，当然找不到。
- 统一用绝对路径：
<link rel="stylesheet" href="/css/style.css">（开头加/） - Webpack/Vite等构建工具需配
base: '/'或publicPath: '/'，避免打包后路径带子目录前缀 - 如果必须支持子目录部署（如
https://example.com/myapp/），HTML里用<base href="/myapp/">，所有相对URL自动补前缀
GitHub Pages/Netlify等平台不支持自定义伪静态，硬配会失效
这些静态托管平台没有传统Web服务器，所谓“伪静态”其实是靠客户端路由或平台级重定向实现的，直接扔一个.htaccess或改nginx.conf完全无效。
GitHub Pages只认根目录下的404.html，且不执行任何服务端重写；Netlify靠_redirects文件或netlify.toml，例如写/blog/:id /blog.html?id=:id 200才能模拟动态路由。Vercel则依赖vercel.json里的rewrites数组。
- GitHub Pages上想实现
/post/123→/post.html?id=123，只能靠JavaScript在post.html里解析URL参数，服务端无能为力 - Netlify部署前检查
_redirects文件是否在发布根目录，且每行末尾不能有多余空格，否则整条规则静默失效 - 本地测试用
npx serve -s无法模拟Netlify的重定向行为，必须推送到平台实测
伪静态真正起作用的地方，永远在服务端配置与前端路径约定的交界处——少一个/，多一个模块未启用，或平台根本不支持，都会让整个链路断在404上。最麻烦的不是规则怎么写，而是确认它到底有没有被执行。
