package com.stylefeng.guns.modular.system.util; import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; import com.stylefeng.guns.modular.system.dao.GDKeyMapper; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; import org.springframework.web.client.RestTemplate; import javax.annotation.PostConstruct; import java.util.ArrayList; import java.util.List; import java.util.Set; import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.CopyOnWriteArrayList; import java.util.concurrent.atomic.AtomicInteger; /** * 高德地图key管理器 *

* 功能: * 1. key池管理:从 t_gaode_account 表加载可用key(启用、未删除、未用完),轮询获取; * 表为空或全部用尽时降级使用兜底key(原硬编码key)。 * 2. 自动切换:调用方检测到key"次数用完"后调用 reportExhausted 上报, * 管理器将key移出内存池并置库表 useStatus=3(已用完)。 * 3. 每日凌晨重置校验:每天 00:00 将 useStatus=3 的key重置为未使用并放回池, * 随后调用高德最轻量接口校验配额是否真正恢复;未恢复的key重新标记已用完, * 进入延迟重试队列,每30分钟校验一次直到恢复额度。 * 4. 兜底key:当天用完仅内存禁用,次日凌晨自动恢复;不写库(表内无对应记录)。 */ @Component public class GDKeyManager { private static final Logger logger = LoggerFactory.getLogger(GDKeyManager.class); /** * 兜底key(原硬编码key):管理端/用户端 */ public static final String FALLBACK_KEY = "39b31fa22955efa8fce9eed487241db9"; /** * 配额校验接口:最轻量的通用Web服务接口,每次仅消耗1次配额 */ private static final String VERIFY_URL = "https://restapi.amap.com/v3/geocode/geo?output=JSON&address=%E5%8C%97%E4%BA%AC%E5%B8%82&key="; @Autowired private GDKeyMapper gdKeyMapper; @Autowired private RestTemplate restTemplate; /** * 内存可用key池(refreshPool整体替换,保证getKey不会看到clear/addAll中间态) */ private volatile List availableKeys = new CopyOnWriteArrayList<>(); /** * 轮询下标 */ private final AtomicInteger index = new AtomicInteger(0); /** * 延迟校验队列:key -> 已重试次数(每日凌晨校验未恢复的key) */ private final ConcurrentHashMap pendingVerifyKeys = new ConcurrentHashMap<>(); /** * 兜底key当日是否已用完 */ private volatile boolean fallbackExhausted = false; /** * 已标记"使用中"(useStatus=2)的key集合,避免热路径每次取用都写库 */ private final Set inUseKeys = ConcurrentHashMap.newKeySet(); @PostConstruct public void init() { refreshPool(); } /** * 刷新可用key池 */ public synchronized void refreshPool() { try { List keys = gdKeyMapper.selectAvailableKeys(); List newPool = new CopyOnWriteArrayList<>(); if (keys != null) { newPool.addAll(keys); } // 整体替换,避免clear/addAll中间态导致getKey短暂看到空池误降级兜底key availableKeys = newPool; logger.info("[GDKeyManager] 高德key池刷新完成,可用key数:{}", newPool.size()); } catch (Exception e) { // 表不存在(用户端/司机端未建表时)等异常:降级使用兜底key,不影响系统运行 logger.warn("[GDKeyManager] 加载高德key失败(t_gaode_account表可能不存在),降级使用兜底key", e); availableKeys = new CopyOnWriteArrayList<>(); } } /** * 获取一个可用key:池非空轮询池内key;池空使用兜底key(当日未用完时) */ public String getKey() { List pool = availableKeys; if (!pool.isEmpty()) { String key = pickFromPool(pool); markInUse(key); return key; } if (!fallbackExhausted) { return FALLBACK_KEY; } // 兜底key当日也已用完:尝试刷新池(可能有新录入的key) refreshPool(); pool = availableKeys; if (!pool.isEmpty()) { String key = pickFromPool(pool); markInUse(key); return key; } return FALLBACK_KEY; } /** * 从内存池轮询取一个key(使用调用方传入的池快照,避免与定时刷新交叉导致越界) */ private String pickFromPool(List pool) { int i = Math.abs(index.getAndIncrement() % pool.size()); return pool.get(i); } /** * 将表内key标记为"使用中"(useStatus=2): * 仅key首次被取用时写库一次;兜底key不写库;写库失败不影响取key流程。 */ private void markInUse(String key) { if (key == null || FALLBACK_KEY.equals(key) || inUseKeys.contains(key)) { return; } try { gdKeyMapper.updateUseStatus(key, 2); inUseKeys.add(key); logger.info("[GDKeyManager] 高德key[{}]开始使用,已标记为使用中", key); } catch (Exception e) { // 表不存在等异常:本次不标记,下次取用再尝试,不影响业务 logger.warn("[GDKeyManager] 标记高德key[{}]使用中失败(表可能不存在),不影响使用", key); } } /** * 定时刷新key池:每5分钟一次,让管理后台新录入的key及时生效 */ @Scheduled(fixedDelay = 5 * 60 * 1000, initialDelay = 60 * 1000) public void scheduledRefreshPool() { refreshPool(); } /** * 上报某个key次数用完: * 表内key -> 移出内存池 + 置库表 useStatus=3; * 兜底key -> 仅内存当日禁用(不写库),次日凌晨自动恢复。 */ public void reportExhausted(String usedKey) { if (usedKey == null || usedKey.isEmpty()) { return; } availableKeys.remove(usedKey); inUseKeys.remove(usedKey); if (FALLBACK_KEY.equals(usedKey)) { fallbackExhausted = true; logger.warn("[GDKeyManager] 兜底key次数已用完,今日禁用,次日凌晨自动恢复"); return; } try { gdKeyMapper.updateUseStatus(usedKey, 3); logger.warn("[GDKeyManager] 高德key[{}]次数用完,已标记为已用完并移出key池", usedKey); } catch (Exception e) { logger.warn("[GDKeyManager] 更新高德key[{}]使用状态失败(表可能不存在),仅内存剔除", usedKey); } } /** * 判断Web服务API响应是否为"次数用完/不可用"(依据infocode) */ public static boolean isWebKeyExhausted(JSONObject resp) { if (resp == null) { return false; } String infocode = resp.getString("infocode"); if (infocode == null || infocode.isEmpty()) { return false; } switch (infocode) { case "10001": // key不正确或过期 case "10003": // 超过每日配额 case "10004": // 访问过于频繁 case "10005": // 超出每秒访问量限制 case "10010": // 权限不足 case "10012": // 服务未开放/权限不足 case "10019": // 使用配额已用尽 case "10020": // 并发超限 case "10044": // 签名错误/未开通 return true; default: return false; } } /** * 判断猎鹰API响应是否为"次数用完"(依据errcode/errmsg) */ public static boolean isFalconExhausted(JSONObject resp) { if (resp == null) { return false; } int errcode = resp.getIntValue("errcode"); if (errcode == 10000) { return false; } if (errcode == 20001) { return true; // 权限不足 } String errmsg = resp.getString("errmsg"); if (errmsg == null) { return false; } return errmsg.contains("配额") || errmsg.contains("上限") || errmsg.contains("次数") || errmsg.contains("用完") || errmsg.contains("超限") || errmsg.contains("quota") || errmsg.contains("limit"); } // ==================== 每日凌晨重置 + API校验恢复额度 ==================== /** * 每日凌晨 00:00 自动执行: * 1. 将 useStatus=3(已用完)的key重置为未使用并放回内存池; * 2. 调用高德API校验配额是否真正恢复; * 3. 未恢复的key重新标记已用完,进入延迟重试队列,直到恢复额度。 */ @Scheduled(cron = "0 0 0 * * ?") public void dailyResetAndVerify() { logger.info("[GDKeyManager] 开始每日高德key配额重置校验"); // 兜底key当日禁用标记次日自动恢复 fallbackExhausted = false; List exhaustedKeys; try { exhaustedKeys = gdKeyMapper.selectExhaustedKeys(); } catch (Exception e) { logger.warn("[GDKeyManager] 查询已用完key失败(表可能不存在),跳过重置校验", e); return; } if (exhaustedKeys == null || exhaustedKeys.isEmpty()) { logger.info("[GDKeyManager] 无已用完的key,跳过重置校验"); return; } for (String gdKey : exhaustedKeys) { // 1. 先重置为未使用 try { gdKeyMapper.updateUseStatus(gdKey, 1); } catch (Exception e) { logger.warn("[GDKeyManager] 重置key[{}]使用状态失败", gdKey, e); } // 2. 调用API校验是否真正恢复额度 boolean recovered = verifyQuota(gdKey); if (recovered) { if (!availableKeys.contains(gdKey)) { availableKeys.add(gdKey); } pendingVerifyKeys.remove(gdKey); logger.info("[GDKeyManager] 高德key[{}]配额已恢复,重新加入key池", gdKey); } else { // 未恢复:重新标记已用完,进入延迟重试队列 try { gdKeyMapper.updateUseStatus(gdKey, 3); } catch (Exception e) { logger.warn("[GDKeyManager] 回写key[{}]已用完状态失败", gdKey, e); } availableKeys.remove(gdKey); pendingVerifyKeys.put(gdKey, 0); logger.warn("[GDKeyManager] 高德key[{}]配额尚未恢复,进入延迟重试队列", gdKey); } } } /** * 延迟重试任务:每30分钟校验一次待恢复的key,直到恢复额度为止 */ @Scheduled(fixedDelay = 30 * 60 * 1000, initialDelay = 30 * 60 * 1000) public void retryPendingKeys() { if (pendingVerifyKeys.isEmpty()) { return; } for (String gdKey : new ArrayList<>(pendingVerifyKeys.keySet())) { boolean recovered = verifyQuota(gdKey); if (recovered) { try { gdKeyMapper.updateUseStatus(gdKey, 1); } catch (Exception e) { logger.warn("[GDKeyManager] 恢复key[{}]使用状态失败", gdKey, e); } if (!availableKeys.contains(gdKey)) { availableKeys.add(gdKey); } pendingVerifyKeys.remove(gdKey); logger.info("[GDKeyManager] 高德key[{}]延迟校验通过,配额已恢复,重新加入key池", gdKey); } else { int count = pendingVerifyKeys.merge(gdKey, 1, Integer::sum); logger.warn("[GDKeyManager] 高德key[{}]配额仍未恢复(已校验{}次),继续等待", gdKey, count); } } } /** * 调用高德最轻量接口校验配额是否恢复 * * @return true=已恢复(或无法判断,保守放行);false=明确未恢复(配额类错误) */ private boolean verifyQuota(String gdKey) { try { String resp = restTemplate.getForObject(VERIFY_URL + gdKey, String.class); JSONObject json = JSON.parseObject(resp); String status = json.getString("status"); String infocode = json.getString("infocode"); if ("1".equals(status) && "10000".equals(infocode)) { return true; } // 权限类错误:该key未开通Web服务校验权限(如猎鹰专用key),无法判断配额,按已恢复处理 if ("10044".equals(infocode) || "10012".equals(infocode) || "10002".equals(infocode) || "10010".equals(infocode)) { logger.info("[GDKeyManager] 高德key[{}]无Web服务校验权限(infocode={}),按已恢复处理", gdKey, infocode); return true; } // 配额类错误:明确未恢复 if ("10001".equals(infocode) || "10003".equals(infocode) || "10019".equals(infocode)) { return false; } // 其他错误(限流/网络等):保守放行,真实调用失败时会被自动切换机制再次标记 return true; } catch (Exception e) { logger.warn("[GDKeyManager] 校验key[{}]配额异常,按已恢复处理", gdKey, e); return true; } } }