当前位置：首页 > news >正文

Spring Boot 项目集成 License 授权与续期完整指南

news 来源：原创 2025/6/8 14:57:40

一、背景说明

在 Spring Boot 项目中，通过引入第三方 spring-boot-starter-license 组件，可以快速实现系统权限到期控制、License 证书管理等功能。本文详细介绍如何集成 License 功能，并解决证书安装、权限配置、异常拦截及续期流程等关键问题。

二、功能版本说明

1. 基础功能（1.0）

集成三方 spring-boot-starter-license-2.0.0.jar 实现 License 管理。
支持证书安装、有效期校验、异常拦截。

2. 增强功能（2.0）

明确证书文件存储路径：C:/license（Windows）或 /usr/local/pingtech/license（Linux）。
开放 /license/** 接口访问权限，支持证书状态查询。
全局异常拦截，定义标准化错误码。

3. 续期功能（3.0）

支持通过 Web 页面生成新证书（license.lic）。
提供 /license/import 接口上传并重新安装证书。

三、安装与配置步骤

1. 准备证书文件

将以下文件拷贝到指定目录：

license.lic：License 证书文件。
publicCerts.keystore：公钥证书库文件。

存储路径：

Windows: C:/license/ Linux: /usr/local/pingtech/license/

2. 引入依赖包

在 pom.xml 中通过 Maven 安装并引用组件：

<!-- 手动安装 JAR（首次需执行） -->
mvn install:install-file 
  -Dfile=path\spring-boot-starter-license-2.0.0.jar 
  -DgroupId=cn.com.pingtech 
  -DartifactId=spring-boot-starter-license 
  -Dversion=2.0.0 
  -Dpackaging=jar

<!-- 项目依赖 -->
<dependency>
    <groupId>cn.com.pingtech</groupId>
    <artifactId>spring-boot-starter-license</artifactId>
    <version>2.0.0</version>
</dependency>

3. 配置权限拦截

在 Spring Security 或类似权限框架中，关闭对 /license/** 路径的认证拦截：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/license/**").permitAll() // 允许匿名访问
            .anyRequest().authenticated();
    }
}

4. 全局异常处理

添加 License 相关异常拦截逻辑，返回标准化错误码：

@RestControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(value = {NoLicenseInstalledException.class})
    public ResponseEntity<String> handleNoLicense(Exception e) {
        return ResponseEntity
            .status(HttpStatus.FORBIDDEN)
            .body("没有安装有效的证书，请联系管理员购买证书");
    }

    @ExceptionHandler(value = {LicenseContentException.class})
    public ResponseEntity<String> handleLicenseInvalid(Exception e) {
        return ResponseEntity
            .status(HttpStatus.FORBIDDEN)
            .body(e.getMessage());
    }
}