Hexo部署云服务器出现404错误的常见原因与解决方案
一、部署路径或配置文件错误
Hexo部署到云服务器时，若_config.yml中的根路径（root）或部署路径（deploy）配置错误，会导致生成的静态文件无法正确映射到服务器目录，从而触发404错误。例如：当服务器设置的网站根目录为/var/www/html，而Hexo生成的public文件夹未正确上传至该路径时，访问请求将无法定位资源。
典型修复步骤：
- 检查
_config.yml的deploy节点，确认目标服务器地址和目录 - 执行
hexo clean清除旧缓存文件 - 重新生成并部署：
hexo g -d
二、域名解析与服务器配置问题
当绑定自定义域名时，DNS解析未生效或服务器未配置虚拟主机，可能造成404错误。例如：云服务器的Nginx/Apache未设置针对域名的server_name匹配规则，或未正确配置CNAME记录时，用户访问请求无法正确路由到Hexo生成的静态资源。
常见排查点：
- 域名A记录/CNAME是否指向服务器IP
- 服务器Web服务是否配置默认站点
- SSL证书配置是否影响HTTP/HTTPS跳转
三、文件名与资源访问限制
云服务器文件系统对大小写敏感，若Hexo生成的页面文件名包含大写字母，在Linux服务器上可能因路径大小写不匹配导致404错误。例如：AboutMe.md生成的链接为/aboutme，但实际文件名为AboutMe.html时，访问将失败。
| 错误类型 | 解决方案 |
|---|---|
| 特殊字符 | 使用URL编码或替换为连字符 |
| 空格 | 改用下划线或短横线 |
| 大小写混合 | 统一使用小写命名 |
四、服务器环境兼容性异常
部分云服务器的Node.js版本与Hexo存在兼容性问题，或未正确安装渲染插件（如hexo-renderer-marked），可能导致生成页面时部分资源丢失。建议通过node -v和hexo version检查环境版本，确保符合Hexo官方要求。
云服务器部署Hexo出现404错误时，需系统检查配置文件、服务器路径、域名解析、环境依赖等关键环节。建议采用hexo server本地测试后，通过SCP/RSync等工具手动验证文件同步完整性，再结合服务器日志（如Nginx的error.log）定位具体问题。
