语法错误会导致Nginx配置加载失败而非try_files失效；需先用nginx -t验证语法，确保try_files仅在location块中使用，并检查error.log中的重定向循环、变量展开及fallback路径有效性。
语法错误本身不会让 try_files “失效”，而是会让整个 Nginx 配置加载失败——Nginx 根本起不来，或者 reload 时直接报错退出。所以排查重点不是“为什么没生效”，而是“为什么配置没被加载”。
看 nginx -t 是否通过
这是第一道关卡，必须做：
- 执行
nginx -t，如果输出test is successful，说明语法基本没问题； - 如果报错，错误信息通常明确指出哪一行、哪个指令出问题，比如：
nginx: [emerg] invalid number of arguments in "try_files" directive
或nginx: [emerg] "try_files" directive is not allowed here（常见于写在 server 块顶层，而非 location 内）； - 注意：
try_files只能在location块中使用，不能放在server或http级别。
检查日志里有没有重定向循环
语法正确但逻辑错误，最典型表现是 500 错误和循环日志：
- 查看 error log（通常是
/var/log/nginx/error.log），搜索关键词：rewrite or internal redirection cycle； - 一旦出现，说明
try_files的 fallback（如/index.html）触发了重新匹配，又回到同一个location，形成死循环； - 常见诱因：
– root/alias 路径与 fallback 路径不一致（例如 alias 设为/app/dist，却写try_files $uri $uri/ /index.html，而实际 index.html 在/app/dist/index.html）；
– 没加location = /index.html精确拦截；
– base 路径未同步到 try_files（如前端设了base: '/admin'，但 Nginx 还是用/index.html）。
确认变量是否被正确展开
$uri 是解码后的路径，容易和 $request_uri 混淆：
- 比如请求
/user/%E4%BD%A0%E5%A5%BD（含中文编码），$uri是/user/你好，而$request_uri是原始带编码的字符串； - 若你用
alias+ 中文路径，又依赖$uri查找文件，可能因系统 locale 或文件名编码不一致导致“找不到”； - 调试技巧：临时加一条
return 200 "$uri\n$request_uri\n";到对应 location，用 curl 直接看变量值。
验证 fallback 是否真能访问到
最后一个参数（fallback）不是“随便写个路径就行”，它必须满足两个条件：
- 是内部重定向 URI（以
/开头），且该路径能被某个location命中； - 命中后，那个 location 必须有合法的响应能力（比如有
root+index，或alias指向真实文件，或proxy_pass）； - 举例：
– 错误写法：try_files $uri /index.html;+location / { root /data; }→/index.html会去/data/index.html找，但如果文件实际在/data/app/index.html就 404；
– 正确写法：try_files $uri /app/index.html;，或配location = /index.html { alias /data/app/index.html; }。
