能否将SpringBoot与NextJS整合打包为同端口运行的单Jar/WAR包

完全可以实现，整合后整套应用仅需对外暴露Spring Boot的8080端口，无需额外占用Next.js默认的3000端口，分两种适配场景实现： #

这是成本最低的整合方案，适合大多数前端仅做交互、所有动态数据通过接口从Spring Boot获取的场景：

• 修改Next.js项目根目录下的next.config.js配置，添加输出规则：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    output: 'export',
    // 若应用部署在非根路径，还需添加basePath配置，比如部署在/demo路径就填basePath: '/demo'
  }
  module.exports = nextConfig
  

• 执行Next.js打包命令：npm run build，打包完成后会在项目根目录生成out文件夹，里面是所有编译后的静态资源。
• 将out文件夹下的所有文件拷贝到Spring Boot项目的src/main/resources/static目录下。
• （可选，适配Next.js客户端路由）新增Spring Boot配置类，将所有404请求转发到index.html，避免刷新页面出现404问题：

  @Configuration
  public class WebConfig implements WebMvcConfigurer {
      @Override
      public void addViewControllers(ViewControllerRegistry registry) {
          registry.addViewController("/{path:[^\\.]*}").setViewName("forward:/index.html");
      }
  }
  

• 正常执行mvn package打包Spring Boot为Jar/WAR即可，运行后直接访问8080端口就能访问Next.js页面，接口请求走Spring Boot的原有逻辑。

如果需要用到Next.js的服务端渲染、增量静态生成等服务端能力，可以用standalone输出+本地代理的方式实现单端口暴露：

• 修改next.config.js配置，指定standalone输出模式：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    output: 'standalone',
  }
  module.exports = nextConfig
  

• 执行npm run build打包，将生成的.next/standalone目录、.next/static目录、项目根目录的public目录统一拷贝到Spring Boot项目的src/main/resources/next目录下。
• 在Spring Boot启动逻辑中添加内嵌服务管理：应用启动时自动拉起本地Next.js Node服务，指定监听127.0.0.1的随机本地端口（不会对外暴露）。
• 配置Spring Boot内置Tomcat的反向代理规则，将所有前端相关请求转发到本地启动的Next.js服务端口，接口请求走原有Spring Boot逻辑。

注意：该方案的运行环境需要预装Node.js运行时，也可以将对应平台的Node.js二进制文件一起打包进Jar包实现开箱即用。

内容的提问来源于stack exchange，提问作者anubhav verman