404 not found nginx(dist打包后,刷新和跳转都是404 not found nginx的问题) 解决方案(打包发布在服务器)

本文讲述了在使用Vue项目时,配置Nginx遇到404问题的原因,重点介绍try_files指令的作用,以及为何仅配置index会导致错误。作者强调了try_files的可靠性和Vue路由对index.html的依赖性。
摘要由CSDN通过智能技术生成

当我们执行了yarn run build之后,生成dist文件

我们将代码放入nginx-1.24.0下面的html中

然后我们就配置conf文件下的nginx.conf

 配置方面不介绍了,主要问题是因为没有加这句话

 问题分析

index index.htm index.html;
index 就是根目录,也就是只识别“/”结尾的,输入不存在或者刷新页面的路径就直接报nginx的404了,而不会重定向到index.html

try_files 更加可靠, 首先会查找"$uri"下的这个文件,如果不存在会查找$uri/,如果还不存在就会重定向到 /index.html页面。如果最后参数写错了,就会导致500的服务器错误。

一般这两个不要写在同一个location

关于为啥vue项目只配置index刷新会404:
vue + nginx的配置, vue路由必须先加载 index.html 或者XX.js 才能识别到路由

这个是各个参数的解释,

# 1.假设请求 127.0.0.1/home
 
# 2.nginx配置的location
location / {
    root   /opt/dist;
    index  index.html;
    try_files $uri $uri/ /index.html;
    }
 
 
# 变量解释
try_files  固定语法
$uri       指代home文件(ip地址后面的路径,假如是127.0.0.1/index/a.png,那就指代index/a.png)
$uri/      指代home文件夹
/index.html  向ip/index.html 地址发起请求
 
 
try_files $uri $uri/ /index.html;
尝试解析下列2个文件/文件夹(自动分辨出,IP后面的路径是文件还是文件夹), $uri/$uri/,
如果解析到,返回第一个,
如果都没有解析到,向127.0.0.1/index.html发起请求跳转(该路由必须真实,不然会报错)

 

### 解决方案 为了防止在Nginx中部署前端项目时出现静态资源404错误,可以通过合理配置Nginx来解决问题。以下是具体的解决方案: #### 1. 配置 `location` 块以匹配前端路由 当Vue项目的路径跳转涉及单页应用(SPA)时,可能会因为未正确设置Nginx的重写规则而导致页面无法加载或返回404错误。此时应确保所有的请求都指向根目录下的HTML文件。 ```nginx server { listen 80; server_name yourdomain.com; root /path/to/your/vue/project/dist; # Vue打包后的dist目录位置 index index.html; location / { try_files $uri /index.html; # 将所有未知路径导向到index.html } location /static/ { # 如果有单独的/static/路径用于存储静态资源 alias /path/to/your/vue/project/dist/static/; expires max; # 设置缓存策略 } } ``` 上述配置中的 `try_files $uri /index.html` 是核心部分[^1],它可以确保即使URL不对应实际存在的文件,也会被解析为 `index.html` 文件的内容,从而让前端框架接管路由逻辑。 #### 2. 启用静态资源缓存 为了避免频繁读取磁盘影响性能,可以启用浏览器端的缓存机制。这不仅能够提升用户体验,还能减轻服务器的压力。 ```nginx location ~* \.(?:css|js|jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|ogg|ogv|webm|htc)$ { access_log off; log_not_found off; add_header Cache-Control "public, no-transform"; expires 365d; # 缓存一年 } location ~* \.(?:html|xml|json)$ { add_header Cache-Control "no-cache"; # 动态内容不应缓存 } ``` 此段代码定义了不同类型的文件对应的缓存时间[^3]。对于图片、CSS样式表以及JavaScript脚本等长期不变的资源,建议将其有效期设得较长;而对于可能经常更新的数据,则需禁用缓存功能以免旧版本残留。 #### 3. 调整日志级别排查问题 如果仍然遇到某些特定情况下发生404的情况,可临时调整Nginx的日志记录等级至更详细的程度以便于诊断具体原因所在。 ```nginx error_log /var/log/nginx/error.log debug; access_log /var/log/nginx/access.log main; ``` 完成修改之后记得重启服务使更改生效,并观察新产生的日志信息寻找异常之处。 --- ### 总结 通过上述方法——即适当地编写Nginx配置文件里的`location`区块规则、开启针对不同类型资产对象的有效期管理措施还有必要时候增强错误追踪力度—就可以有效预防因路径映射失误所引发出来的静态文档丢失状况的发生[^2]。 ```python # 示例Python代码仅作装饰用途,与当前主题无关。 def example_function(): pass ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值