一、报错现象Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.6.3:exec on project ruoyi-modules-system: Command execution failed. Process exited with an error: 1Maven 只是执行器真正的问题在 Spring Boot 启动阶段。应用没起来Maven 才以退出码 1 结束。二、两类最容易误导的日志误导点 1dynamic-datasource initial loaded [0/1] datasource这条日志是判断 Nacos 配置是否生效的关键指标应优先看日志内容含义下一步loaded [0] datasourceNacos 里数据源配置没加载进来查 Nacos 连通性、YAML 解析、编码问题loaded [1] datasource, primary named [master]数据源配置已生效数据源问题可排除转查 MyBatis / 业务配置分析思维看到 MyBatis / Mapper 报错 ↓ 先往回看数据源日志不要直接改 Mapper ↓ [0] datasource → 根因在 Nacos 配置未注入编码、YAML、Data ID [1] datasource → Nacos 基础配置已 OK再查 MyBatis 专属配置典型陷阱看到[1] datasource就认为「全都好了」但MyBatis 的mapper-locations、type-aliases-package与数据源在同一份 Nacos YAML 里。若之前是[0]阶段修复编码后变成[1]说明 Nacos 已能解析若 MyBatis 仍报错再单独核对别名、包路径不要回头怀疑 Mapper 接口或 XML 写错。误导点 2Invalid bound statement: com.ruoyi.system.mapper.SysConfigMapper.selectConfigList这类报错非常像代码问题容易让人去改 Mapper实际上经常是配置未加载的连锁反应Nacos YAML 解析失败UTF-8/GBK ↓ mybatis.mapper-locations 未生效 ↓ Mapper 接口能扫描到MapperScan 仍工作 Mapper XML 没被加载进 SqlSessionFactory ↓ 调用 selectConfigList() 时报 Invalid bound statement (not found): ...SysConfigMapper.selectConfigList为什么容易误判表象容易得出的错误结论实际情况接口里有selectConfigList方法名写错方法名没问题XML 里有对应select idselectConfigListXML 路径或 id 写错XML 本身没问题target/classes/mapper/.../SysConfigMapper.xml存在编译/打包问题资源已在 classpath报错指向具体 Mapper 方法要改 Java/XML根因是 MyBatis 没扫到 XML正确排查顺序看dynamic-datasource是[0]还是[1]看有没有MalformedInputException/YAMLException确认 Nacos 里mybatis.mapper-locations是否生效最后才核对 Mapper 接口与 XML通常无需改代码中间还出现过Could not resolve type alias SysDept属于同一链条type-aliases-package配错如只写com.ruoyi.system.domain与selectConfigList找不到是同类配置问题不是实体类缺失。三、完整排查思维链路Maven BUILD FAILURE ↓ 看 Spring 启动日志不看 Maven 本身 ↓ ┌─ dynamic-datasource loaded [0] ? │ ↓ 是 │ Nacos 配置未生效 → 查 YAMLException / 编码 / Data ID │ ↓ │ 连锁无数据源 无 mapper-locations │ ↓ │ 误导性报错SysConfigMapper.selectConfigList not found │ └─ dynamic-datasource loaded [1] ? ↓ 是 数据源 OK继续看 MyBatis ↓ SysDept / selectConfigList 等报错 ↓ 查 type-aliases-package、mapper-locations仍在 Nacos 同一份配置里 ↓ 一般不用改 Mapper 代码四、根因说明1. Nacos 配置依赖本地bootstrap.yml只负责连 Nacos业务配置在远程配置项作用spring.datasource.dynamic数据源决定[0]还是[1]mybatis.mapper-locations决定 XML 是否加载影响selectConfigList等mybatis.type-aliases-package决定SysDept等别名应用com.ruoyi.systemspring.cloud.gateway.routes网关路由影响/auth/login404任意环节解析失败都会引发下游「像代码错了」的报错。2. UTF-8 编码问题Windows 默认常为GBKNacos 配置含中文注释如# spring配置、# 认证中心解析触发MalformedInputException→整份 YAML 失效表现为[0] datasource 各类 MyBatis BindingException3. 网关 404 同一性质/auth/login返回 404 且 auth 无日志 →ruoyi-gateway-dev.yml路由未加载与 system 模块是同一类 Nacos 编码问题。五、解决方案方案 AJVM 强制 UTF-8各服务 VM options 添加-Dfile.encodingUTF-8方案 BNacos 配置去除中文各*-dev.yml删除中文注释关键项示例mybatis: type-aliases-package: com.ruoyi.system mapper-locations: classpath*:mapper/**/*.xml方案 CIDE 编码统一File Encodings全部UTF-8。方案 D命名空间未配namespace即public无需额外选择保证 Data ID 为{application.name}-dev.yml即可。六、验证清单无MalformedInputExceptiondynamic-datasource initial loaded [1] datasource不是[0]无Invalid bound statement: ...SysConfigMapper.selectConfigList无Could not resolve type alias SysDept网关/auth/login能打到 auth 服务七、经验总结要点说明[0]vs[1] datasource是分水岭[0]先修 Nacos[1]再查 MyBatis 细项Mapper 报错常是烟雾弹selectConfigList not found多因mapper-locations未加载不是接口/XML 写错同一份 Nacos YAML 管多条线数据源、MyBatis、路由一起失效或一起恢复Windows 开发必盯编码中文注释 GBK 是若依微服务常见坑一句话先用dynamic-datasource loaded [0/1]判断 Nacos 是否生效SysConfigMapper.selectConfigList等 MyBatis 报错往往是配置未加载的结果而非原因根因是Nacos 配置因 UTF-8/GBK 不一致解析失败。