Rails 7中如何实现仅单次API请求的无刷新分页？

一、确保仅调用一次外部API #

你已经使用Rails低级缓存实现了基础的API请求复用，这里补充细节优化，保证逻辑严谨：

1. 缓存键唯一性：当前缓存键"merchants/#{current_user.platform_merchant_id}/transactions"已关联用户唯一标识，避免不同用户的交易数据混叠，无需调整。
2. 全量数据拉取：如果实际交易记录可能超过100条，需调整per_page参数为API支持的最大值，或实现循环拉取所有分页数据的逻辑，确保缓存包含完整的交易列表。
3. 缓存时效调整：expires_in: 12.hours可根据业务数据更新频率灵活修改，比如交易数据实时性要求高的场景，可缩短为1小时。

最终控制器代码（保留你的逻辑并补充注释）：

# transactions_controller.rb
class TransactionsController < ApplicationController
  def index
    # 用pagy_array处理本地数组的分页逻辑
    @pagy, @transactions = pagy_array(cached_transactions.body['data'], items: 8)
  end

  private

  def cached_transactions
    Rails.cache.fetch("merchants/#{current_user.platform_merchant_id}/transactions", expires_in: 12.hours) do
      # 一次性拉取目标范围内的全量交易数据
      client.transactions.list(platform_merchant_id: current_user.platform_merchant_id, page: 1, per_page: 100)
    end
  end

  def client
    @client ||= TestAPI::Client.new
  end
end

二、实现无刷新（AJAX）分页 #

基于Rails7默认的Turbo框架，结合pagy的Turbo支持，可快速实现无刷新分页：

步骤1：调整视图结构，标记可更新区域 #

清理原视图中冗余的HTML标签，为表格主体和分页导航添加唯一ID，方便后续局部更新：

# views/transactions/index.html.erb
<table class="table table-striped">
  <thead>
    <tr>
      <th>Date</th>
      <th>Amount</th>
    </tr>
  </thead>

  <tbody id="transactions-tbody">
    <% @transactions.each do |transaction| %>
      <tr>
        <td><%= transaction['created_at'] %></td>
        <td><%= transaction['amount_cents'] %></td>
      </tr>
    <% end %>
  </tbody>
</table>

<div id="pagy-nav">
  <%== pagy_bootstrap_nav(@pagy, data: { turbo: true }) %>
</div>

步骤2：创建Turbo Stream响应模板 #

在views/transactions目录下新建index.turbo_stream.erb文件，定义局部更新的逻辑：

# views/transactions/index.turbo_stream.erb
<%= turbo_stream.update "transactions-tbody" do %>
  <% @transactions.each do |transaction| %>
    <tr>
      <td><%= transaction['created_at'] %></td>
      <td><%= transaction['amount_cents'] %></td>
    </tr>
  <% end %>
<% end %>

<%= turbo_stream.update "pagy-nav" do %>
  <%== pagy_bootstrap_nav(@pagy, data: { turbo: true }) %>
<% end %>

步骤3：自动触发无刷新请求 #

Rails7控制器默认支持Turbo响应，当用户点击分页链接时，Turbo会自动发送AJAX请求，控制器返回Turbo Stream模板，局部更新表格和分页导航，实现无刷新分页效果。

额外注意事项 #

• 若API返回数据量极大（如上万条），本地分页会占用较多内存，此时建议让API支持分页，同时缓存每个分页的结果（需设计更复杂的缓存键）。
• 缓存失效时，下一次请求会自动重新拉取API数据，保证数据不会过于陈旧。

内容的提问来源于stack exchange，提问作者mr_muscle