JooLun Plus 百科 ⬇ 源码下载

03.04 图形验证码机制

102353 于 2026-10-17 14:14:33 +08:00 修改了此页面

验证码直接由网关异步生成,基于 WebFlux;图片由 kaptcha 生成,个性配置请参看官方文档。

WebFlux 生成验证码的 Handler

public class ImageCodeHandler implements HandlerFunction<ServerResponse> {
	private final Producer producer;
	private final RedisTemplate redisTemplate;

	@Override
	public Mono<ServerResponse> handle(ServerRequest serverRequest) {
		// 生成验证码
		String text = producer.createText();
		BufferedImage image = producer.createImage(text);

		// 保存验证码信息
		String randomStr = serverRequest.queryParam("randomStr").get();
		redisTemplate.opsForValue().set(CommonConstants.DEFAULT_CODE_KEY + randomStr, text, 60, TimeUnit.SECONDS);

		// 转换流信息写出
		FastByteArrayOutputStream os = new FastByteArrayOutputStream();
		try {
			ImageIO.write(image, "jpeg", os);
		} catch (IOException e) {
			log.error("ImageIO write err", e);
			return Mono.error(e);
		}

		return ServerResponse
			.status(HttpStatus.OK)
			.contentType(MediaType.IMAGE_JPEG)
			.body(BodyInserters.fromResource(new ByteArrayResource(os.toByteArray())));
	}
}

WebFlux 请求处理入口

public class RouterFunctionConfiguration {
	private final HystrixFallbackHandler hystrixFallbackHandler;
	private final ImageCodeHandler imageCodeHandler;

	@Bean
	public RouterFunction routerFunction() {
		return RouterFunctions.route(
			RequestPredicates.GET("/code").and(RequestPredicates.accept(MediaType.TEXT_PLAIN)),
			imageCodeHandler
		);
	}
}

校验逻辑

通过 OAuth2 终端的 client-id 来确定是否校验验证码。

public class ValidateCodeGatewayFilter extends AbstractGatewayFilterFactory {
	@Override
	public GatewayFilter apply(Object config) {
		return (exchange, chain) -> {
			ServerHttpRequest request = exchange.getRequest();

			// 终端设置不校验,直接向下执行
			String[] clientInfos = WebUtils.getClientId(request);
			if (filterIgnorePropertiesConfig.getClients().contains(clientInfos[0])) {
				return chain.filter(exchange);
			}

			// 校验验证码
			checkCode(request);

			return chain.filter(exchange);
		};
	}
}

配置终端不校验验证码

修改 joolun-gateway-dev.yml

ignore:
  clients:
    - test
  swagger-providers:
    - ${AUTH-HOST:joolun-auth}