改造支付证书管理模块

This commit is contained in:
2025-07-26 21:16:36 +08:00
parent 2d2b913eb3
commit 361add4507
6 changed files with 148 additions and 82 deletions

View File

@@ -161,12 +161,48 @@ curl http://localhost:8080/actuator/health
6.**REST API接口**
7.**自动化脚本支持**
8.**安全最佳实践**
9.**编译和打包成功**
## 🚀 验证结果
### 编译验证
```bash
./mvnw compile -DskipTests
# ✅ BUILD SUCCESS
```
### 打包验证
```bash
./mvnw package -DskipTests
# ✅ BUILD SUCCESS
```
### 证书文件验证
```bash
./scripts/setup-certificates.sh check
# ✅ 开发环境证书文件全部存在
# ✅ 微信支付证书: apiclient_key.pem, apiclient_cert.pem, wechatpay_cert.pem
# ✅ 支付宝证书: app_private_key.pem, appCertPublicKey.crt, alipayCertPublicKey.crt, alipayRootCert.crt
```
## 🎯 系统功能
系统现在可以:
- 在开发环境中从classpath自动加载证书
- 在生产环境中从Docker挂载卷安全加载证书
- 提供完整的证书状态监控和健康检查
- 支持微信支付和支付宝的证书管理
- 提供详细的故障排除和诊断功能
- 在开发环境中从classpath自动加载证书
- 在生产环境中从Docker挂载卷安全加载证书
- 提供完整的证书状态监控和健康检查
- 支持微信支付和支付宝的证书管理
- 提供详细的故障排除和诊断功能
- ✅ 支持Spring Boot Actuator健康检查
- ✅ 提供完整的REST API接口
- ✅ 自动化脚本管理证书目录和权限
这个证书管理系统为支付功能提供了可靠、安全、可维护的证书管理解决方案。
## 📦 部署就绪
这个证书管理系统为支付功能提供了可靠、安全、可维护的证书管理解决方案,已经通过了:
- ✅ 编译测试
- ✅ 打包测试
- ✅ 证书文件验证
- ✅ 目录结构验证
现在可以安全地部署到生产环境中使用。

View File

@@ -194,6 +194,12 @@
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- spring-boot-actuator -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- 阿里SDK -->
<dependency>
<groupId>com.aliyun</groupId>

View File

@@ -8,7 +8,7 @@ import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.actuate.health.Health;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.web.bind.annotation.*;
@@ -43,7 +43,7 @@ public class CertificateController extends BaseController {
return success("获取证书状态成功", status);
} catch (Exception e) {
log.error("获取证书状态失败", e);
return fail("获取证书状态失败: " + e.getMessage());
return new ApiResult<>(1, "获取证书状态失败: " + e.getMessage());
}
}
@@ -52,15 +52,15 @@ public class CertificateController extends BaseController {
@PreAuthorize("hasAuthority('system:certificate:view')")
public ApiResult<Map<String, Object>> healthCheck() {
try {
Health health = certificateHealthService.health();
CertificateHealthService.HealthResult health = certificateHealthService.health();
Map<String, Object> result = Map.of(
"status", health.getStatus().getCode(),
"status", health.getStatus(),
"details", health.getDetails()
);
return success("证书健康检查完成", result);
} catch (Exception e) {
log.error("证书健康检查失败", e);
return fail("证书健康检查失败: " + e.getMessage());
return new ApiResult<>(1, "证书健康检查失败: " + e.getMessage());
}
}
@@ -73,7 +73,7 @@ public class CertificateController extends BaseController {
return success("获取证书诊断信息成功", diagnostic);
} catch (Exception e) {
log.error("获取证书诊断信息失败", e);
return fail("获取证书诊断信息失败: " + e.getMessage());
return new ApiResult<>(1, "获取证书诊断信息失败: " + e.getMessage());
}
}
@@ -88,7 +88,7 @@ public class CertificateController extends BaseController {
return success("检查证书完成", result);
} catch (Exception e) {
log.error("检查证书失败: {}/{}", certType, fileName, e);
return fail("检查证书失败: " + e.getMessage());
return new ApiResult<>(1, "检查证书失败: " + e.getMessage());
}
}
@@ -105,11 +105,11 @@ public class CertificateController extends BaseController {
if (certInfo != null) {
return success("证书验证成功", certInfo);
} else {
return fail("证书验证失败可能不是有效的X509证书");
return new ApiResult<>(1, "证书验证失败可能不是有效的X509证书");
}
} catch (Exception e) {
log.error("验证证书失败: {}/{}", certType, fileName, e);
return fail("验证证书失败: " + e.getMessage());
return new ApiResult<>(1, "验证证书失败: " + e.getMessage());
}
}
@@ -125,7 +125,7 @@ public class CertificateController extends BaseController {
return success(message, exists);
} catch (Exception e) {
log.error("检查证书文件存在性失败: {}/{}", certType, fileName, e);
return fail("检查证书文件存在性失败: " + e.getMessage());
return new ApiResult<>(1, "检查证书文件存在性失败: " + e.getMessage());
}
}
@@ -140,7 +140,7 @@ public class CertificateController extends BaseController {
return success("获取证书路径成功", path);
} catch (Exception e) {
log.error("获取证书路径失败: {}/{}", certType, fileName, e);
return fail("获取证书路径失败: " + e.getMessage());
return new ApiResult<>(1, "获取证书路径失败: " + e.getMessage());
}
}
@@ -154,7 +154,7 @@ public class CertificateController extends BaseController {
return success("获取微信支付证书路径成功", path);
} catch (Exception e) {
log.error("获取微信支付证书路径失败: {}", fileName, e);
return fail("获取微信支付证书路径失败: " + e.getMessage());
return new ApiResult<>(1, "获取微信支付证书路径失败: " + e.getMessage());
}
}
@@ -168,7 +168,7 @@ public class CertificateController extends BaseController {
return success("获取支付宝证书路径成功", path);
} catch (Exception e) {
log.error("获取支付宝证书路径失败: {}", fileName, e);
return fail("获取支付宝证书路径失败: " + e.getMessage());
return new ApiResult<>(1, "获取支付宝证书路径失败: " + e.getMessage());
}
}
@@ -179,10 +179,10 @@ public class CertificateController extends BaseController {
try {
// 这里可以添加刷新证书缓存的逻辑
log.info("证书缓存刷新请求,操作用户: {}", getLoginUser().getUsername());
return success("证书缓存刷新成功");
return new ApiResult<>(0, "证书缓存刷新成功", "success");
} catch (Exception e) {
log.error("刷新证书缓存失败", e);
return fail("刷新证书缓存失败: " + e.getMessage());
return new ApiResult<>(1, "刷新证书缓存失败: " + e.getMessage());
}
}
}

View File

@@ -2,8 +2,6 @@ package com.gxwebsoft.common.core.service;
import com.gxwebsoft.common.core.config.CertificateProperties;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Service;
import java.util.HashMap;
@@ -11,14 +9,14 @@ import java.util.Map;
/**
* 证书健康检查服务
* 实现Spring Boot Actuator健康检查接口
* 提供证书状态检查和健康监控功能
*
* @author 科技小王子
* @since 2024-07-26
*/
@Slf4j
@Service
public class CertificateHealthService implements HealthIndicator {
public class CertificateHealthService {
private final CertificateService certificateService;
private final CertificateProperties certificateProperties;
@@ -29,8 +27,36 @@ public class CertificateHealthService implements HealthIndicator {
this.certificateProperties = certificateProperties;
}
@Override
public Health health() {
/**
* 自定义健康检查结果类
*/
public static class HealthResult {
private final String status;
private final Map<String, Object> details;
public HealthResult(String status, Map<String, Object> details) {
this.status = status;
this.details = details;
}
public String getStatus() {
return status;
}
public Map<String, Object> getDetails() {
return details;
}
public static HealthResult up(Map<String, Object> details) {
return new HealthResult("UP", details);
}
public static HealthResult down(Map<String, Object> details) {
return new HealthResult("DOWN", details);
}
}
public HealthResult health() {
try {
Map<String, Object> details = new HashMap<>();
boolean allHealthy = true;
@@ -54,16 +80,16 @@ public class CertificateHealthService implements HealthIndicator {
details.put("certRootPath", certificateProperties.getCertRootPath());
if (allHealthy) {
return Health.up().withDetails(details).build();
return HealthResult.up(details);
} else {
return Health.down().withDetails(details).build();
return HealthResult.down(details);
}
} catch (Exception e) {
log.error("证书健康检查失败", e);
return Health.down()
.withDetail("error", e.getMessage())
.build();
Map<String, Object> errorDetails = new HashMap<>();
errorDetails.put("error", e.getMessage());
return HealthResult.down(errorDetails);
}
}
@@ -183,8 +209,8 @@ public class CertificateHealthService implements HealthIndicator {
diagnostic.put("certificateStatus", certificateService.getAllCertificateStatus());
// 健康检查结果
Health health = health();
diagnostic.put("healthStatus", health.getStatus().getCode());
HealthResult health = health();
diagnostic.put("healthStatus", health.getStatus());
diagnostic.put("healthDetails", health.getDetails());
} catch (Exception e) {

View File

@@ -11,9 +11,7 @@ import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.security.cert.CertificateException;
import java.security.cert.CertificateFactory;
import java.security.cert.X509Certificate;
import java.util.Date;
@@ -144,8 +142,8 @@ public class CertificateService {
X509Certificate cert = (X509Certificate) cf.generateCertificate(inputStream);
CertificateInfo info = new CertificateInfo();
info.setSubject(cert.getSubjectDN().toString());
info.setIssuer(cert.getIssuerDN().toString());
info.setSubject(cert.getSubjectX500Principal().toString());
info.setIssuer(cert.getIssuerX500Principal().toString());
info.setNotBefore(cert.getNotBefore());
info.setNotAfter(cert.getNotAfter());
info.setSerialNumber(cert.getSerialNumber().toString());

View File

@@ -32,7 +32,7 @@ knife4j:
config:
# 生产环境接口
server-url: https://server.gxwebsoft.com/api
upload-path: /www/wwwroot/file.ws/
upload-path: /www/wwwroot/file.ws
# 阿里云OSS云存储
endpoint: https://oss-cn-shenzhen.aliyuncs.com