用crystalruby构建高性能Web服务：Kemal+Rails混合架构实战，性能比Sinatra快4倍

用crystalruby构建高性能Web服务：Kemal+Rails混合架构实战，性能比Sinatra快4倍

【免费下载链接】crystalruby Embed Crystal code directly in Ruby 项目地址: https://gitcode.com/gh_mirrors/cr/crystalruby

如果你正在为 Ruby Web 服务的性能发愁，又不想放弃 Rails 的开发效率，那么 crystalruby 值得你认真了解。这个开源 gem 允许你直接在 Ruby 代码中内联编写 Crystal 代码，通过 FFI 自动编译链接，让关键路径获得接近原生编译语言的性能。在官方压测中，用 crystalruby 搭建的 Kemal 混合架构 Web 服务 吞吐量达到每秒 2.3 万请求，比同场景下的 Sinatra 快 4 倍，是追求高性能 Web 服务时不可错过的利器。

crystalruby 是什么：把 Crystal 代码内联进 Ruby 的利器

简单来说，crystalruby 是一个"翻译桥"：你用 Ruby 的语法写方法体，只要它是合法的 Crystal 语法，加上 crystallize 声明和类型标注，这个方法就会被编译成 Crystal 原生代码，下次调用走的是 FFI，而不是 Ruby 解释器。

require "crystalruby"

crystallize :int
def add(a: :int, b: :int)
  a + b
end

puts add(1, 2) # => 3，但这一行跑在 Crystal 里

官方基准里，同样的素数计数逻辑，纯 Ruby 耗时 3.04 秒，而 crystalruby 编译后的版本只要 0.06 秒——快了约 50 倍。最诱人的是，改动成本极低：只需给方法加一行注解，无需改写整个项目。完整的入门示例可以参考 examples/adder/adder.rb 和项目 README.md。

为什么要用"Rails + Crystal"混合架构

纯 Ruby（如 Sinatra）开发快但算力弱，纯 Crystal（如 Kemal）性能强但生态和开发效率不如 Rails。混合架构的思路是：用 Rails 处理业务、路由、鉴权等"灵活"部分，用 Crystal 承担计算密集的"重活"。

crystalruby 让这种架构变得极其自然：

• Ruby 调 Crystal：用 crystallize 把热点方法交给 Crystal；
• Crystal 调 Ruby：用 expose_to_crystal 把 Ruby 方法暴露给 Crystal 调用；
• 双向共享对象：通过 CRType 定义引用类型，大数组、哈希等数据结构可以按引用传递，避免反复拷贝（相关实现见 lib/crystalruby/adapter.rb）。

性能实测：Kemal 混合架构比 Sinatra 快 4 倍

官方用 wrk 压测工具对三种架构做了对比：Kemal 纯 Crystal、Kemal 混合（路由回调 Ruby）、Sinatra 纯 Ruby，结果如下：

可以看到，混合方案比纯 Ruby 快约 4 倍，同时达到了纯 Crystal 方案约 66% 的性能。换句话说：你几乎免费拿到了 Crystal 的速度，又保留了 Ruby 的灵活性。

crystalruby 安装教程：三步完成环境准备

上手非常简单，前提是你本机装了 Crystal 编译器。

1. 安装 gem：gem install crystalruby，或在 Gemfile 中加入 gem "crystalruby" 后执行 bundle；
2. 生成默认配置：bundle exec crystalruby init，会生成 crystalruby.yaml（含 crystal_src_dir、crystal_codegen_dir 等路径项，详见 lib/crystalruby/config.rb）；
3. 在代码里 require "crystalruby"，写第一个 crystallize 方法即可。

配置也可以在代码里动态设置，比如生产环境关闭 debug、开启 release 编译：

CrystalRuby.configure do |config|
  config.debug = false            # 生产环境使用 release 编译
  config.single_thread_mode = true # 单线程程序可跳过 Reactor 开销
end

Kemal + Rails 混合架构搭建步骤

第一步：声明 Kemal shard 依赖

crystalruby 支持在 Ruby 源码里直接声明 Crystal 依赖（shard），编译时会自动执行 shards install 并注入到生成的 shard.yml：

require "crystalruby"

shard :kemal, github: "kemalcr/kemal"

第二步：用 crystallize 启动 Kemal 服务器

async: true 让服务器在 Reactor 中并发运行，不阻塞其他 Ruby 线程：

crystallize async: true
def start_server
  Kemal.run(3000, [""])
end

第三步：expose_to_crystal 让 Crystal 回调 Ruby

混合架构的精髓在这一步：Kemal 跑在 Crystal 里，但指定路由可以回调 Ruby 方法，把"灵活"留给 Ruby：

expose_to_crystal
def return_ruby_response(returns: String)
  "Hello World! #{Random.rand(0..100)}"
end

crystal do
  get "/kemal_rb" do
    return_ruby_response
  end
end

start_server

第四步：接入 Rails 应用

在 Rails 中，你可以在 Controller 或 Service 里直接使用 crystallize 包裹重计算逻辑：Ruby 负责解析请求、做认证，Crystal 负责密集计算，最后再由 Ruby 渲染响应。crystalruby 还支持热重载——检测到内联 Crystal 代码变更后自动重编译，非常适合 Rails 开发环境快速迭代。大型项目还可以用 lib: 参数把 Crystal 代码拆成多个共享库，只重编译有变更的部分，显著缩短编译时间。

让混合服务更快的 4 个配置技巧

1. 开启单线程模式：如果程序本身是单线程的，设置 single_thread_mode = true 可完全绕过 Reactor 的同步开销（每次调用约 10 微秒），见 lib/crystalruby/reactor.rb；
2. 大对象按引用传递：用 CRType{ Array(Int32) } 这类命名类型，让百万级数组不再被反复拷贝；
3. 异步化长任务：给方法加 async: true，5 个线程各自 sleep 2 秒时，同步模式要 10 秒，异步模式只需 2 秒（有对应测试佐证，见 test/test_async_methods.rb）；
4. 生产环境 release 编译：config.debug = false 关闭调试符号，换取更快的执行速度。

常见问题排查

• 编译缓慢：Crystal 项目越大编译越慢，用 lib: 拆库、只重编译变更部分；
• 多线程调用异常：确认没有误开 single_thread_mode，或按需把方法标记为 async；
• 生成产物异常：执行 bundle exec crystalruby clean 清空重新构建。

写在最后

crystalruby 用极低的改造成本，让 Ruby 开发者同时拥有 Rails 的生态与 Crystal 的速度。从加一行注解开始，到跑起混合架构的 Web 服务，再到压测中比 Sinatra 快 4 倍的吞吐——这条性能优化路径，值得每一个被 Ruby 性能困扰的团队尝试。

【免费下载链接】crystalruby Embed Crystal code directly in Ruby 项目地址: https://gitcode.com/gh_mirrors/cr/crystalruby