ThinkPHP5与Vue.js整合：彻底解决刷新页面404问题
在使用ThinkPHP5作为后端API，Vue.js构建前端项目的过程中，如果前端采用history模式路由并部署在ThinkPHP5的public目录下，刷新页面常常会遇到404错误。本文将深入分析此问题并提供有效的解决方案。
问题描述：许多开发者在使用ThinkPHP5构建后端接口，并用Vue.js开发前端页面时，会遇到一个常见问题：前端采用history模式打包，部署在ThinkPHP5项目的public目录下，首次访问正常，但刷新页面时却出现404错误。 以下是一个典型的Nginx配置文件示例：
location / {
root e:/www/doctorlink/public;
index index.php index.html index.htm;
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}
之所以出现这个问题，是因为刷新页面时，浏览器直接请求Vue Router生成的URL路径，而这些路径对应的文件并不存在于public目录下。
立即学习“PHP免费学习笔记（深入）”；
解决方案：问题的核心在于Nginx配置没有正确处理Vue Router的history模式URL请求。 原有的rewrite指令仅在文件不存在时将请求转发到index.php，无法处理Vue Router生成的URL。 因此，需要修改Nginx配置，将所有请求都正确地转发到index.html。 推荐使用以下修改后的Nginx配置：
location / {
root E:/www/doctorLink/public;
index index.html;
# 解决404
try_files $uri $uri/ /index.html;
}
通过try_files $uri $uri/ /index.html;指令，Nginx会依次尝试：
-
$uri：查找用户请求的URL路径对应的文件。 -
$uri/：如果1不存在，则尝试在该路径下查找目录。 -
/index.html：如果1和2都不存在，则返回index.html文件。
这样，即使是Vue Router生成的URL也能被正确处理，有效避免了404错误。 此方法比原有的rewrite指令更简洁高效，更适合处理Vue Router的history模式。
