1小时用OpenResty搭建可扩展微服务网关原型

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

开发一个微服务网关原型，要求：1.服务自动发现(对接Consul)；2.支持轮询/权重负载均衡；3.熔断降级机制；4.请求/响应日志；5.简单的管理界面。使用OpenResty实现核心功能，生成可直接部署的Docker镜像配置和快速启动脚本，注释关键实现逻辑。

1. 点击'项目生成'按钮，等待项目生成完整后预览效果

最近在团队里需要快速验证一个微服务网关的技术方案，用OpenResty花1小时就搭出了可用的原型。记录下这个高效的开发过程，特别适合需要快速验证架构的场景。

1. 为什么选择OpenResty OpenResty基于Nginx和Lua，性能接近原生Nginx的同时又能用Lua灵活扩展。相比从零写网关，它内置了反向代理、负载均衡等基础功能，我们只需要用Lua脚本补充业务逻辑就行。最关键是启动速度极快，改完代码reload配置就能生效，特别适合原型开发阶段频繁调整。

2. 核心功能实现步骤

3. 服务发现对接Consul
   通过Lua脚本定时调用Consul的HTTP API获取服务实例列表，解析JSON响应后存到共享内存。这里用了ngx.timer.every实现定时轮询，避免每次请求都查Consul。健康检查失败的服务实例会自动从列表剔除。

4. 负载均衡策略
   在balancer_by_lua阶段实现两种算法：

5. 轮询：维护一个计数器，每次请求按顺序选择实例

6. 加权轮询：根据Consul返回的服务权重分配流量
   关键点是使用shared.DICT保证计数器的原子性操作。

7. 熔断降级机制
   记录每个服务实例的失败次数，达到阈值后标记为不可用。通过lua_shared_dict实现跨worker的状态共享，配合降级逻辑（如返回缓存数据或默认值）。后续通过定时任务尝试恢复。

8. 调试与优化技巧

9. 用content_by_lua输出调试信息时，注意先清除默认的content-type头
10. 共享内存的大小需要预估好，太小会导致数据被LRU淘汰
11. 在init_by_lua阶段预加载公共模块，避免运行时重复编译

12. 用reload代替restart来应用配置变更，保证流量无损

13. 管理界面实现 用lua-resty-template渲染简单HTML页面，展示当前路由规则、实例状态和熔断情况。添加基础认证保证安全，关键代码如下：

nginx location /admin { access_by_lua '-- 校验账号密码'; content_by_lua 'template.render("dashboard.html")'; }

1. Docker化部署 基于openresty/alpine镜像，把lua脚本和nginx配置打包进去。通过环境变量控制Consul地址等配置，启动脚本自动生成最终配置：

dockerfile FROM openresty/openresty:alpine COPY lua /usr/local/openresty/lualib/app CMD ["sh", "generate_config.sh && nginx -g 'daemon off;'"]

整个过程最耗时的其实是调试负载均衡算法，后来发现是shared.DICT的key冲突导致的。建议原型阶段先实现最小闭环，再逐步添加功能。

这个原型后来我们用InsCode(快马)平台做了线上演示，不用操心服务器配置就直接生成了可访问的URL。他们的OpenResty环境预装了常用库，上传代码文件就能实时看到效果，特别适合快速验证方案。如果你们也需要类似的技术预研，推荐试试这种"代码即部署"的体验。

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

开发一个微服务网关原型，要求：1.服务自动发现(对接Consul)；2.支持轮询/权重负载均衡；3.熔断降级机制；4.请求/响应日志；5.简单的管理界面。使用OpenResty实现核心功能，生成可直接部署的Docker镜像配置和快速启动脚本，注释关键实现逻辑。

1. 点击'项目生成'按钮，等待项目生成完整后预览效果