vue项目直接访问index报404

项目登录后进入首页,自动跳转至/index页面,此时无异常。
在这里插入图片描述
但是如果从其它页面跳转至/index页面或直接访问时,nginx报404错误。

经查,是nginx需单独对vue项目进行配置,如下:

location / {
        root   /usr/share/nginx/html;
        try_files $uri $uri/ /index.html;
        index  index.html index.htm;
    }

就是其中的 try_files $uri $uri/ /index.html;

解释:用于定义Nginx如何处理对服务器的请求。这条指令的作用是尝试按顺序访问指定的文件或目录,如果前面的文件或目录不存在,则请求会被重定向到后面的资源。
$uri:这是当前请求的URI(统一资源标识符)。Nginx会首先尝试直接根据这个URI去服务器上的文件系统中找到对应的文件。如果找到了,就直接返回这个文件的内容给客户端。
u r i / :如果第一个 uri/:如果第一个 uri/:如果第一个uri对应的文件不存在,Nginx会尝试将这个URI当作一个目录来处理,尝试访问这个目录下的默认文件(比如index.html或者index.php,这取决于配置文件中的index指令)。
/index.html:如果前面的两个尝试都失败了(即指定的文件或目录都不存在),Nginx会将请求重定向到服务器的根目录下的index.html文件。这通常用于单页面应用(SPA)中,确保无论用户访问哪个路径,都能加载到应用的入口页面,然后由前端路由来处理不同的路径。
这种配置方式非常适合于部署前端单页面应用(SPA),因为它可以确保所有路由请求最终都能被正确地引导到应用的入口页面,而不会因为404错误而中断。同时,它也能处理静态资源的请求,如果这些资源存在于服务器上对应的路径下。

保存配置文件后,重启nginx服务,再次访问/index,完成。

### 解决 Nginx 部署 Vue 项目出现 404 错误的方法 #### 修改 Nginx 配置文件以支持 HTML5 History Mode Vue.js 单页应用程序 (SPA) 使用 HTML5 的历史记录 API 来管理导航,这使得 URL 不再指向实际存在的静态资源。当用户尝试通过浏览器直接访问这些路径或刷新页面时,服务器会试图寻找对应的实际文件而返回 404 错误。 为了使 Nginx 正确处理这种请求并将其重定向至 `index.html` 文件,可以在配置文件中加入如下设置: ```nginx server { listen 80; server_name localhost; location / { root /path/to/your/vue/dist; # 替换成自己的dist目录位置 try_files $uri $uri/ /index.html; } error_page 500 502 503 504 /50x.html; } ``` 这段配置中的关键部分是 `try_files $uri $uri/ /index.html;` 这一行[^1]。它告诉 Nginx 尝试按顺序匹配给定的 URI 和子目录下的默认首页;如果都未找到,则回退到 `/index.html`,从而让前端路由接管后续逻辑。 #### 确认构建后的静态文件放置正确 确保经过打包命令生成的生产环境版本已经成功上传到了指定的服务根目录下,并且该目录内的结构保持完整无损。通常情况下,Vue CLI 构建工具会在执行 `npm run build` 后创建一个名为 `dist` 的文件夹来存储编译成果物。 #### 设置正确的 MIME 类型 有时不恰当的内容类型声明也会引发显示异常。因此建议确认 Nginx 是否能够识别并发送合适的 Content-Type 头信息给客户端。可以通过添加下面几行代码实现这一点: ```nginx types { text/html html htm shtml; } default_type application/octet-stream; ``` 以上措施有助于提高兼容性和加载效率[^3]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值