LogiCommon 项目常见问题解决方案

LogiCommon 项目常见问题解决方案

1. 项目基础介绍和主要编程语言

LogiCommon 是一个由滴滴开源的 Java 项目，旨在提供认证、鉴权、管理和任务调度等通用功能组件。该项目的主要模块包括 Logi-security 和 Logi-job，分别用于处理用户认证、鉴权、管理和分布式定时调度服务。LogiCommon 的设计目标是与具体业务解耦，提供简单易用、轻量高效的解决方案，同时支持多平台适配和功能扩展。

2. 新手在使用 LogiCommon 项目时需要特别注意的 3 个问题及详细解决步骤

问题 1：如何正确配置 Maven 依赖

问题描述：
新手在使用 LogiCommon 时，可能会遇到 Maven 依赖配置错误的问题，导致项目无法正常运行。

解决步骤：

1. 打开项目的 pom.xml 文件。
2. 添加 Logi-security 和 Logi-job 的 Maven 依赖：

   <dependency>
       <groupId>io.github.zqrferrari</groupId>
       <artifactId>logi-security-spring-boot-starter</artifactId>
       <version>1.6.3</version>
   </dependency>
   <dependency>
       <groupId>io.github.zqrferrari</groupId>
       <artifactId>logi-job-spring-boot-starter</artifactId>
       <version>1.0.10</version>
   </dependency>
   

3. 保存 pom.xml 文件并刷新 Maven 项目，确保依赖正确下载。

问题 2：如何配置 Logi-security 的数据源

问题描述：
Logi-security 模块需要配置数据源信息，新手可能会因为配置错误导致无法连接数据库。

解决步骤：

1. 在项目的 application.yml 或 application.properties 文件中添加以下配置：

   logi.security.app-name: ES
   logi.security.resource-extend-bean-name: myResourceExtendImpl
   logi.security.username: root
   logi.security.password: 123456
   logi.security.url: jdbc:mysql://localhost:3306/logi_security?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
   logi.security.driver-class-name: com.mysql.jdbc.Driver
   

2. 确保数据库连接信息（如用户名、密码、URL）正确无误。
3. 启动项目，检查是否能够正常连接数据库。

问题 3：如何实现 ResourceExtend 接口

问题描述：
Logi-security 的资源权限管理模块需要用户实现 ResourceExtend 接口，新手可能会因为未实现该接口导致功能无法正常使用。

解决步骤：

1. 创建一个新的 Java 类，例如 MyResourceExtendImpl，并实现 ResourceExtend 接口：

   import io.github.zqrferrari.logi.security.ResourceExtend;
   
   public class MyResourceExtendImpl implements ResourceExtend {
       @Override
       public Resource getResource(String resourceId) {
           // 实现获取资源信息的逻辑
           return new Resource();
       }
   }
   

2. 在 Spring 配置文件中注册该实现类：

   @Bean
   public ResourceExtend myResourceExtendImpl() {
       return new MyResourceExtendImpl();
   }
   

3. 在 application.yml 中配置 resource-extend-bean-name：

   logi.security.resource-extend-bean-name: myResourceExtendImpl
   

4. 重新启动项目，确保资源权限管理模块功能正常。

通过以上步骤，新手可以顺利解决在使用 LogiCommon 项目时遇到的常见问题，确保项目能够正常运行。