Rails局部视图调用控制器传参异常：ID被替换为用户名

问题原因 #

出现这个问题通常有三个核心诱因：

• Wallet模型重写了to_param方法：如果模型里把to_param改成返回关联用户的用户名，路由生成时会自动用用户名代替钱包ID，导致params[:id]变成用户名，Wallet.find自然找不到对应记录。
• 局部视图link_to传参错误：用wallet: f.object的方式传参，没有直接把钱包实例传给路由辅助方法，Rails错误解析了参数逻辑。
• Form Builder对象错配：如果局部视图的f是User模型的表单构建器，f.object实际是User实例，传给路由后会把用户名当作ID参数。

解决方案 #

1. 检查并修正Wallet模型的to_param

打开app/models/wallet.rb，如果存在类似下面的代码，直接删除：

# 错误写法：用用户名代替钱包ID生成路由
def to_param
  user.username
end

Rails默认的to_param会返回模型ID的字符串形式，保留默认即可让路由正确使用钱包ID。

2. 修正局部视图的link_to写法

在_wallet_fields.html.erb里，把错误的传参方式：

<%= link_to '更新', wallet_path(wallet: f.object) %>

改成直接传入钱包实例：

<%= link_to '更新', wallet_path(f.object) %>

确保f是Wallet的表单构建器（比如通过fields_for :wallet渲染局部视图时，f就是钱包的表单对象），此时f.object就是正确的Wallet实例。

3. 确认表单嵌套的正确性

如果局部视图是嵌套在User表单里的，要确保用fields_for正确关联钱包：

# 父视图（比如users/edit.html.erb）
<%= form_with(model: @user) do |f| %>
  <%= f.fields_for :wallet do |wallet_form| %>
    <%= render 'wallet_fields', f: wallet_form %>
  <% end %>
<% end %>

这样局部视图里的f就是Wallet的表单构建器，f.object肯定是Wallet实例，不会出现传用户对象的情况。

4. 验证控制器的查找逻辑

确认WalletsController里的find_wallet方法是用ID查找：

# app/controllers/wallets_controller.rb
before_action :find_wallet

private
def find_wallet
  @wallet = Wallet.find(params[:id])
  # 除非业务特殊需求，否则不要改成用用户名查找，不符合REST规范
end

验证步骤 #

1. 重启Rails服务，清除浏览器缓存。
2. 触发局部视图的更新请求，查看服务器日志中的params输出，确认params[:id]是钱包ID而非用户名。
3. 确认Wallet.find(params[:id])能正常找到对应记录，不再抛出ActiveRecord::RecordNotFound异常。

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