如何在本地运行部署在AWS上的Java-React应用（含.war包Maven项目）

你当前的项目属于前后端同仓的Maven托管Java+React一体化项目，生产环境会统一打包为war包部署，直接用Node运行失败是因为未遵循项目的标准启动流程，按以下步骤操作即可完成本地运行：

1 安装必备基础环境 #

• 安装对应版本JDK：打开项目根目录的pom.xml，找到<java.version>或<maven.compiler.source>标签确认JDK版本（常用为8/11/17），安装对应版本后执行java -version、javac -version验证版本匹配
• 安装Maven：优先选择3.6+版本，配置好国内镜像源后执行mvn -v验证安装成功
• 安装Node.js：进入src/main/frontend目录打开package.json，查看engines字段指定的Node版本，无标注则优先安装16.x/18.x LTS版本，安装后执行node -v、npm -v验证

2 全量打包验证项目完整性 #

打开终端进入项目根目录（与pom.xml同级），执行命令：

mvn clean package -DskipTests

该命令会自动执行前端依赖安装、React生产产物构建、Java代码编译、最终打包为war包的全流程，无报错则说明项目代码和依赖无缺失。

3 本地开发模式启动（调试用，重启速度更快） #

3.1 启动Java后端服务 #

• 找到项目主启动类：SpringBoot项目为带@SpringBootApplication注解的Java类，传统Spring MVC项目可查看pom.xml中war包配置的入口类
• 可通过Java IDE直接点击运行，也可执行命令启动：
  mvn spring-boot:run
• 启动成功后查看控制台端口号，默认为8080，同步修改application.yml/application.properties中的数据库、中间件配置为你本地环境的对应参数

3.2 启动React前端开发服务 #

• 终端进入src/main/frontend目录
• 执行npm install安装全部前端依赖
• 查看package.json的scripts字段，找到本地启动命令（通常为start或dev），执行对应命令即可：
  npm run start
• 启动成功后控制台会输出前端访问地址，默认为http://localhost:3000，项目一般已配置代理规则，会自动将API请求转发到后端8080端口，无需额外处理跨域问题。

常见问题排查 #

• Maven打包报依赖找不到：检查Maven的settings.xml配置，替换为阿里云公共镜像源
• npm install报错：删除node_modules文件夹和package-lock.json文件后重试，仍失败则切换Node版本到匹配的LTS版本
• 接口跨域：临时在后端主启动类添加@CrossOrigin注解，或修改前端代理配置

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