Skip to content

服务清单与端口 ​

砚考的 HTTP 端口定义在各模块自己的 src/main/resources/application.yml 中,而不是 Nacos 配置里;Nacos 只负责数据源、中间件地址与业务参数。排错时别找错地方。

端口分配规则 ​

区间归属
8080网关
8800 / 17888SnailJob 调度服务端
9100SpringBoot Admin 监控
9201 ~ 9205框架自带业务服务
9210认证中心
9211 ~ 9220考试业务服务(10 个)
9221Python AI Agent
20880 起Dubbo RPC 端口(dubbo.protocol.port: -1 自增)

基础设施与框架服务 ​

服务artifactId端口必需说明
ruoyi-gatewayruoyi-gateway8080✅Spring Cloud Gateway(WebFlux),统一入口:鉴权、路由、限流、请求日志
ruoyi-gateway-mvcruoyi-gateway-mvc8080二选一Servlet MVC 版网关。当前未配置 exam 路由,请勿直接用它跑考试业务
ruoyi-authruoyi-auth9210✅登录/登出/验证码/注册/社交登录/租户列表
ruoyi-systemruoyi-system9201✅用户、部门、岗位、角色、菜单、字典、参数、通知、租户、客户端、AI 模型配置
ruoyi-genruoyi-gen9202可选代码生成
ruoyi-jobruoyi-job9203(+29203)可选SnailJob 任务执行器,29203 为客户端通信端口
ruoyi-resourceruoyi-resource9204推荐文件 / OSS / 短信 / 邮件 / SSE / WebSocket
ruoyi-workflowruoyi-workflow9205可选warm-flow 工作流
ruoyi-monitorruoyi-monitor9100可选SpringBoot Admin 监控中心
ruoyi-snailjob-serverruoyi-snailjob-server8800 / 17888可选SnailJob 服务端
ruoyi-seata-serverruoyi-seata-server8091 / 7091可选Seata 事务协调器

考试业务服务 ​

服务端口网关前缀库职责
ruoyi-exam-question9211/questionry-exam题库分类、题目 CRUD、选项、标签、Excel 导入导出、随机抽题
ruoyi-exam-paper9212/paperry-exam试卷 CRUD、手工 / 随机组卷、试卷题目关联
ruoyi-exam-manage9213/exam、/invitery-exam考试计划、规则、白名单、加入码、考试情况看板
ruoyi-exam-answer9214/answer(StripPrefix=1,内部 /record)ry-exam-answer考试中心、开考、存答案、自动判分、交卷、成绩。高并发写,独立库
ruoyi-exam-mark9215/markry-exam主观题阅卷任务、打分、改分审计、AI 预评
ruoyi-exam-stat9216/statry-exam统计大盘、分数段、题目/知识点分析、重算任务。只读重查询
ruoyi-exam-practice9217/practice(StripPrefix=1,内部 /wrong)ry-exam错题本、错题来源、重做记录
ruoyi-exam-cert9218/certry-exam证书模板、颁发、吊销、我的证书
ruoyi-exam-proctor9219/proctor(StripPrefix=1)ry-exam防作弊会话、事件、抓拍、规则判定
ruoyi-exam-ai9220/airy-examAI Java 网关层(目前仅启动类,无业务代码)
ruoyi-exam-agent9221不经网关—Python FastAPI + LangChain,独立构建,不进 Maven

注意 StripPrefix

answer / practice / proctor 三条路由配置了 StripPrefix=1,对外前缀与内部 @RequestMapping 不一致:

  • 对外 /answer/record/center → 内部 ExamRecordController 的 /record/center
  • 对外 /practice/wrong/overview → 内部 /wrong/overview
  • 对外 /proctor/exam/list → 内部 /exam/list

其余服务的对外前缀与内部路径一致。改路由时千万别搞反。

最小可用组合 ​

只跑核心考试业务,启动这 8 个即可:

bash
# 基础设施
MySQL  Redis  Nacos

# 应用服务(按启动顺序)
ruoyi-gateway   :8080
ruoyi-auth      :9210
ruoyi-system    :9201
ruoyi-exam-question  :9211
ruoyi-exam-paper     :9212
ruoyi-exam-manage    :9213
ruoyi-exam-answer    :9214
ruoyi-exam-mark      :9215

证书、错题本、监考、统计、AI 可按需追加,彼此不阻塞。

包路径规范 ​

基础包名沿用了框架的 org.dromara,考试域在第三级:

text
业务实现:org.dromara.exam.<模块>.{controller, service, service.impl, mapper, domain, dubbo, task}
接口契约:org.dromara.exam.<模块>.api.{RemoteXxxService, domain.*}

示例:

text
org.dromara.exam.question.RuoYiExamQuestionApplication
org.dromara.exam.question.controller.QuestionController
org.dromara.exam.question.dubbo.RemoteQuestionServiceImpl
org.dromara.exam.answer.service.impl.ExamRecordServiceImpl

关于包名迁移

目前 groupId 仍是 org.dromara:ruoyi-cloud-plus:2.6.2,包名沿用 org.dromara。 如果要改成自有包名,请参考 修改包名 并同步修改 MyBatis-Plus 的 mapperPackage、typeAliasesPackage(正则是 org.dromara.**)。

砚考 · 让每一次考试都经得起检验