已初始化若依后端项目需满足:根目录含pom.xml和ruoyiapplication.java;maven依赖解析成功;jdk 17+及java/spring boot扩展已安装;运行ruoyiapplication.java后终端显示“started ruoyiapplication”并监听8080端口。

确认是否已初始化若依后端项目
若依(RuoYi)是基于 Spring Boot 的 Java 后台管理系统,它本身不是 VS Code 原生支持的项目类型,必须先确保你拿到的是完整可运行的后端源码(通常是 ruoyi-admin 模块),而不是只下载了前端或文档。常见错误是直接打开 ruoyi-vue(前后端分离版)的根目录,但没启动后端服务,导致前端报 500 或跨域失败。
- 检查项目根目录下是否有
pom.xml和src/main/java/com/ruoyi/RuoYiApplication.java - 确认
ruoyi-admin是 Maven 模块,且依赖已正确解析(VS Code 中 Java 扩展会显示“Maven Projects”侧边栏) - 若用的是若依微服务版(RuoYi-Cloud),需额外启动 Nacos、Sentinel 等组件,不能只跑
RuoYiApplication
VS Code 中配置并运行 Spring Boot 主类
VS Code 本身不内置 Java 运行环境,必须装好 JDK 17+、Extension Pack for Java(含 Debugger for Java)、Spring Boot Extension Pack。否则点击“运行”会提示 “No Java runtime present” 或找不到 main 方法。
网站功能资讯模块资料模块会员模块产品展示模块产品订购模块购物车模块留言模块在线加盟模块多级后台管理系统网站环境本系统为 asp.net开发donet版本为1.1框架数据库为acdess2000授权方式为免费,本版本本地可直接运行(使用http://localhost或http://127.0.0.1访问)如需放到外网通过域名访问,则需通过qq联系我免费索取钥匙文件,将钥匙文件放到网站空间根目录即可
- 右键
RuoYiApplication.java→ “Run Java”(不是“Run Code”) - 首次运行可能弹出
launch.json配置建议,选“Java”模板即可,无需手动改mainClass,插件能自动识别 - 观察终端输出:成功启动时会有
Started RuoYiApplication in X.XXX seconds,并监听http://localhost:8080 - 若卡在
Tomcat started on port(s): 8080 (http)后无后续,说明启动完成;若卡在数据库连接处,检查application.yml中的spring.datasource.url是否指向本地 MySQL(默认localhost:3306)
前端联调前必须解决跨域和登录路径问题
若依前后端分离版(RuoYi-Vue)默认请求 /prod-api/ 前缀,而后端 Spring Boot 默认不带该前缀。直接 npm run dev 会 404 所有接口,这不是 VS Code 的问题,是配置没对齐。
- 后端需在
application.yml中开启网关或配置路径匹配:spring: mvc: pathmatch: matching-strategy: ant_path_matcher(Spring Boot 2.6+ 必加) - 前端
.env.development中的VUE_APP_BASE_API应为'http://localhost:8080',而非'/prod-api'(后者是生产代理用) - 若仍报跨域,检查后端
@Configuration类中是否启用了@EnableWebMvc—— 若启用了,需手动配CorsConfiguration,否则全局@CrossOrigin失效
调试时别忽略日志和端口冲突
VS Code 的 Java 调试器很稳,但若依启动慢、依赖多,容易掩盖真实问题。比如控制台没报错,但页面一直转圈,大概率是数据库连不上或 Redis 未启动,而不是代码逻辑问题。
- 启动前先执行
mysql -u root -p和redis-cli ping,确认服务在运行 - 若提示
Address already in use: bind,检查是否已有其他 Java 进程占了 8080 —— 可临时改server.port=8081测试 - 调试断点打在
LoginController.login()里,但请求根本没进来?优先看浏览器 Network 面板的 Request URL 和 Status,再查后端日志里有没有Resolved [AuthenticationException]类错误
application.yml、MySQL 用户权限、Redis 密码、还有那个被很多人忽略的 ant_path_matcher 配置。









