配置未生效需先强制终止nginx进程并验证路径：执行taskkill /f /im nginx.exe直至提示“没有任务运行”，再用完整路径和-p/-c参数运行nginx -t校验，确保读取正确conf文件。
配置改了但没生效？先杀光残留进程
宝塔面板点“重载Nginx”经常只是发了个信号，Windows 下 nginx.exe 很容易卡在后台不动，新配置根本没加载。你看到的还是旧页面、Welcome to nginx! 或者 404，大概率是旧进程在扛着。
- 打开 CMD（管理员权限不用，普通用户即可），执行：
taskkill /f /im nginx.exe - 再执行一次，确认输出是“INFO: 没有任务运行”，才算清干净
- 别信面板右上角那个“重载”按钮——它不保证 kill 掉全部子进程，尤其当
nginx -p路径错乱时，会悄悄启一个藏在C:\BtSoft\panel\下的幽灵实例
nginx -t 报错找不到 conf/nginx.conf？路径偏移是元凶
错误提示像这样：nginx: configuration file C:\BtSoft\panel\conf\nginx.conf test failed —— 说明 Nginx 当前工作目录（prefix）被宝塔误设为 C:\BtSoft\panel，而真实配置其实在 C:\BtSoft\nginx\conf\。这不是配置写错了，是启动时根本没读对地方。
- 手动验证：在 CMD 中运行
"C:/BtSoft/nginx/nginx.exe" -p "C:/BtSoft/nginx/" -c "C:/BtSoft/nginx/conf/nginx.conf" -t - 如果这条命令返回
success，就坐实了路径偏移问题 - 后续所有操作（包括面板里点“重启”）都得以这个
-p和-c为准，否则永远在修假问题
刷新页面变 404？history 模式必须加 try_files
Vue/React 项目部署后首页能开，一刷新就 404，不是前端打包问题，是 Nginx 没把路由兜住。浏览器直接向服务器要 /user/profile 这种路径，但磁盘上根本没有这个文件，得靠 try_files 回退到 index.html 让前端自己处理。
- 在宝塔站点配置的
location / { }块里，**必须加这一行**：try_files $uri $uri/ /index.html; - 注意结尾分号不能丢，
$uri/后面的斜杠也不能少，否则目录访问会失败 - 别写成
try_files $uri /index.html;—— 缺少$uri/会导致/admin/这种带斜杠的路径 403 或 404
临时目录缺失导致启动失败？手动补全最稳
nginx -t 报类似 open() "/.../temp/client_body_temp" failed (2: No such file or directory)，说明 Nginx 启动时想建临时目录，但父目录不存在。Windows 版宝塔不会自动创建这些文件夹，报错后直接跳过，服务看似跑起来了，其实用的是内存里的默认 temp 路径，极不稳定。
- 在 CMD 中逐条执行（路径按你实际安装位置调整）：
mkdir "C:\BtSoft\nginx\temp\client_body_temp"、mkdir "C:\BtSoft\nginx\temp\proxy_temp"、mkdir "C:\BtSoft\nginx\temp\fastcgi_temp" - 这三个目录缺一不可，尤其是
client_body_temp，文件上传、大 POST 请求会直接失败 - 补完再跑
nginx -t，如果还报别的 temp 目录错，照着路径 mkdir 就行，别猜，Windows 不会自动递归建多级
真正卡住人的从来不是配置怎么写，而是 Nginx 在 Windows 上压根没按你预期的路径和上下文启动。每次改完，先 taskkill，再 nginx -t 带全路径验证，最后才用带 -p 的命令启动——这三步绕不开，少一步都可能白调半天。
