后端启动与配置故障

BladeX大约 2 分钟故障排查开发指南

后端排查路径

先确认启动模块与 profile，再检查配置来源、基础服务连接和业务初始化。记录具体异常与发生阶段；端口监听之外，还需核对启动日志与业务初始化结果。

一、依赖或启动失败

确认 Java 21、当前 Maven 配置与授权依赖可用，启动入口为 blade-service/blade-api。核对打包后的启动产物和 JVM 参数，类路径与 JAR 名称以当前工程为准。

查看异常中的连接地址、账号及目标库。空库使用当前版本的三份初始化脚本；已有库核对表和字段是否与当前版本一致。Redis 核对地址、认证、数据库编号与运行环境的网络可达性。

配置来源

命令行、环境变量、外部文件和模块配置存在优先级。修改某份 YAML 后，核对当前 profile 和最终加载来源，确认该值实际生效。

登录失败检查账号、租户、客户端及当前环境；报文解密失败核对前端公钥、后端密钥对和接口加密配置。开放接口的 Bearer 密钥与管理端登录令牌分别检查。

资料上传成功但无法预览时，检查记录中的文件地址、桶权限和签名有效期。后端须以自身的网络与凭证读取原文件，服务端可达性与浏览器能否访问该 URL 分别检查。

按资源、租户和当前身份检查数据权限。菜单有按钮但操作被拒绝时，从对应业务接口的权限与资源授权定位，按需为具体角色补充授权。