news 2026/4/23 11:52:15

微服务 - Higress网关

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
微服务 - Higress网关

前面我们已经介绍了微服务网关的基本概念,接下来我们重点介绍如何使用 Higress 来构建高性能的 AI 原生 API 网关。

作为系统的统一入口,Higress 网关为我们提供了以下核心能力:

  • 统一入口:为所有微服务提供统一的访问入口,简化客户端的调用复杂度。

  • 请求路由:根据请求的路径、参数等信息,将请求路由到正确的微服务实例。

  • 负载均衡:在多个服务实例之间分发请求,提高系统的可用性和性能。

  • 安全认证:统一处理身份验证、权限控制等安全相关功能。

  • 限流熔断:实现请求限流、服务熔断等保护机制,防止系统过载。

  • 监控日志:收集请求日志、监控指标等信息,便于系统运维和问题排查

Higress 安装

Higress 的安装需要 Docker 环境支持,启动成功后,可以通过 8001 端口访问 Higress 控制台:

服务来源配置

在 Higress 控制台中配置服务来源,可以从 Nacos 中获取服务来源:

需要注意的是,注册中心地址不支持 127.0.0.1 或 localhost,需要使用本机的内网地址。

配置完成后,Higress 会自动发现在 Nacos 中注册的所有微服务:

但是 Dubbo + Nacos 默认只注册 Dubbo 服务(RPC接口),而不注册 HTTP 接口。我们对外提供的服务都没有被发现,需要手动注册:

路由配置

这样一来,前端只需要访问网关的地址 localhost:8080/api/user/xxx,就会自动转发到对应的服务 localhost:8124/api/user/xxx。

路由配置完成:

完成路由配置后,需要修改前端 vite 请求代理地址为 8080 端口,然后就可以利用前端来测试完整业务流程了,能正常登录和生成网站就说明配置成功。

如果你使用了 Spring Cloud 作为服务发现(而不是 Dubbo),可以 整合 Nacos 快速发现服务。

权限认证问题解决

在微服务改造过程中,我们发现之前的 AOP 鉴权没有生效,因为只有用户模块有 AOP 鉴权类。

比如未登录时调用管理员查询对话历史接口,发现也能调用:

如果我们使用的是 Spring Cloud Gateway,可以在项目入口处自定义鉴权逻辑。但现在 Higress 是独立的组件,很难编写和已有项目集成的自定义逻辑。

怎么办呢?

aop/AuthInterceptor 是一个有点儿特殊的类,由于依赖了 UserService 和 User 实体类,无法放到 common 包中。如果单独存放在用户模块,其他服务想要使用就得引入用户模块(违背了微服务的原则),所以比较快速的解决方案是,后续每个需要鉴权的服务单独复制这个类即可。

比如在应用模块中引入:

@Aspect @Component public class AuthInterceptor { /** * 执行拦截 * * @param joinPoint 切入点 * @param authCheck 权限校验注解 */ @Around("@annotation(authCheck)") public Object doInterceptor(ProceedingJoinPoint joinPoint, AuthCheck authCheck) throws Throwable { String mustRole = authCheck.mustRole(); RequestAttributes requestAttributes = RequestContextHolder.currentRequestAttributes(); HttpServletRequest request = ((ServletRequestAttributes) requestAttributes).getRequest(); // 当前登录用户 User loginUser = InnerUserService.getLoginUser(request); UserRoleEnum mustRoleEnum = UserRoleEnum.getEnumByValue(mustRole); // 不需要权限,放行 if (mustRoleEnum == null) { return joinPoint.proceed(); } // 以下为:必须有该权限才通过 // 获取当前用户具有的权限 UserRoleEnum userRoleEnum = UserRoleEnum.getEnumByValue(loginUser.getUserRole()); // 没有权限,拒绝 if (userRoleEnum == null) { throw new BusinessException(ErrorCode.NO_AUTH_ERROR); } // 要求必须有管理员权限,但用户没有管理员权限,拒绝 if (UserRoleEnum.ADMIN.equals(mustRoleEnum) && !UserRoleEnum.ADMIN.equals(userRoleEnum)) { throw new BusinessException(ErrorCode.NO_AUTH_ERROR); } // 通过权限校验,放行 return joinPoint.proceed(); } }

如果需要鉴权的服务较多,更优雅的方式是写一个单独的鉴权服务,感兴趣的同学可以了解下 OAuth2 协议。

同时,我们可以利用 Higress 插件的请求屏蔽和认证机制,组合使用 Higress + 服务内鉴权,实现多层次的安全防护。

接口文档聚合

在微服务架构中,每个服务都有自己的接口文档,为了方便查看和管理,我们可以考虑接口文档聚合。

Knife4j 提供了 接口文档聚合功能,支持 Cloud 模式自己填写要聚合的服务地址配置;也支持跟 Higress 网关一样,采用 Nacos 模式自动发现。

但很坑的是,这种方式只支持 Spring Boot 2,Spring Boot 3 根本无法启动!

作为替代方案,可以考虑自己写一个导航网站(用 AI 生成即可),点击某个服务后就跳转到对应的接口文档页面。

项目部署

微服务项目的部署相比单体应用更加复杂,需要考虑多个服务的协调启动、服务发现、配置管理等问题。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/15 5:44:12

支持术语干预与上下文翻译|HY-MT1.5-7B模型服务部署笔记

支持术语干预与上下文翻译|HY-MT1.5-7B模型服务部署笔记 随着多语言交流需求的不断增长,高质量、可定制化的机器翻译系统成为企业出海、跨语言内容生成和本地化服务的核心基础设施。腾讯混元团队近期开源了新一代翻译模型 HY-MT1.5 系列,包含…

作者头像 李华
网站建设 2026/4/4 12:43:39

Trae平台对接实践:实现CI/CD式AI模型迭代

Trae平台对接实践:实现CI/CD式AI模型迭代 引言:从单点实验到工程化迭代的挑战 在当前AIGC快速发展的背景下,图像转视频(Image-to-Video)技术正逐步从研究原型走向产品落地。以I2VGen-XL为代表的生成模型具备强大的动…

作者头像 李华
网站建设 2026/4/18 10:29:58

Sambert-HifiGan语音合成API开发指南:快速集成到你的应用

Sambert-HifiGan语音合成API开发指南:快速集成到你的应用 📌 为什么选择Sambert-HifiGan进行中文语音合成? 在智能客服、有声阅读、虚拟主播等场景中,高质量的中文多情感语音合成(Text-to-Speech, TTS)已…

作者头像 李华
网站建设 2026/4/15 9:19:00

网页编辑器如何处理PPT幻灯片内容粘贴的智能分页?

教育网站编辑器攻坚记:Java 开发者的破局之路 作为一名 Java 开发人员,我投身于各类网站开发项目已久,本以为能轻松应对各种技术挑战,然而最近接到的这个教育网站系统开发项目,却让我陷入了前所未有的困境。客户是学校…

作者头像 李华
网站建设 2026/4/23 10:42:45

如何用Sambert-HifiGan实现语音合成A/B测试

如何用Sambert-HifiGan实现语音合成A/B测试 引言:中文多情感语音合成的现实挑战 在智能客服、有声阅读、虚拟主播等应用场景中,高质量、富有情感表现力的中文语音合成已成为用户体验的关键因素。传统的TTS(Text-to-Speech)系统往往…

作者头像 李华