非根目录部署 nextjs 项目,资源文件 404 的问题

问题描述

一般的我们见到的 nextjs 项目部署,按照官方步骤基本上没啥问题,但是今天遇到一个不是太常见的:在网站的子目录部署 nextjs 项目。

最近开发了一个浏览器插件,打算用 nextjs 做一个简单的官方主页,这样显得正式一点,结果在平平无奇的部署上出问题了。

本地开发没有问题,在部署的时候发现网站虽然可以正常打开,但是 JavaScript、css 等资源的状态是 404.

不过,看文件属性的话,该文件在服务器上是明显存在的

只是,nextjs 生成的文件夹是 .next (这点和开发环境一致),不知道为什么在服务端请求变成了 _next,

其他人的方案

网上各种搜索后,看到有人遇到了同样的问题

但是其解决方法试过后并不适用,也可能是 Nginx 的配置问题。如果有大佬懂这方面的,感谢告知。

rewrite 指令的方式,我也试过,但是没有效果。

nginx 复制代码
location /lifetime/_next/static/ {
        alias /home/ubuntu/root/.next/static/;
        expires 365d;
        access_log off;
}
location /lifetime {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:3001;
}
// 当然这里还有另一个解决办法是通过rewrite指令,修改proxy_pass后的url。

Stack Overflow 相关问题

nextjs-deploy-to-a-specific-url-path

看了下,发现别人老早也遇到了类似的问题,但是没发现比较靠谱点的解决方法。

我的笨方法

首先,如果非根目录的话,next.config.js 的这个配置是必须的

js 复制代码
const nextConfig = {
  reactStrictMode: true,
   basePath: '/sub-directory',
   assetPrefix: '/sub-directory'
}
// basePath指定项目的根路径,assetPrefix指定静态资源的路径
module.exports = nextConfig

Nginx 的配置如下:

nginx 复制代码
  location /sub-directory {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:6666;
    }

通过 F12 发现,浏览器请求静态资源的路径是 /sub-directory/_next/static/,但是服务器上是没有 _next 文件夹的。

一个笨方法就是,新建 _next 目录,然后把 /sub-directory/.next/static/ 目录下的所有文件复制到 /sub-directory/_next/static/

写一个脚本文件即可,在 package.json 中添加一个 script 命令即可:

json 复制代码
"build": "next build  && ./copy_next.sh"

对于 nextjs 和 Nginx 还不是非常熟悉。如果您知道问题出在哪里,欢迎告知。

相关推荐
徐小夕20 分钟前
万字长文!DeepSeek Super-agent × 企业知识库架构深度拆解与落地实践
前端·vue.js·github
陈随易32 分钟前
TanStarter,从搭建到支付,一步到位开始赚美元
前端·后端·程序员
前端双越老师1 小时前
程序员 1v1 访谈系列第十二期:普通人没有核心竞争力
前端·ai编程·全栈
柳杉1 小时前
没有写一行代码:我用 Codex 制作 了一个 3D 智慧展厅可视化大屏
前端·ai编程·three.js
IT_陈寒1 小时前
Redis开发实战:从入门到精通
前端·人工智能·后端
恋猫de小郭1 小时前
Flutter Impeller Vulkan 内存持续上涨,问题没想到是文字阴影
android·前端·flutter
0xBADCODE2 小时前
2026 强网杯 Web 题 cwp · 全链路复盘
前端·安全·web安全·网络安全·系统安全·ctf
麦麦麦当劳大王10 小时前
【油猴脚本】Boss直聘 岗位职责复制
开发语言·前端·javascript
小lu飞11 小时前
2026小红书小工具怎么制作:纯前端 ZIP 打包、沙箱限制与笔记挂载流程
前端·笔记·ai·ai编程
smallcelebration11 小时前
151 从0开始搭建后端项目
前端·firefox