Ruby On Rails报错：ProfileController未定义profile_params方法或局部变量

你遇到的undefined local variable or method 'profile_params' for ProfileController:Class 90%以上是下面三个原因导致的：

• profile_params 方法被错误地在类作用域（也就是控制器类定义下、所有实例方法def的外部）调用了。profile_params是控制器的实例方法，只能在update/create这类实例动作方法内部调用，直接写在类层级会触发类找不到该方法的错误。
• 方法名拼写不匹配：比如定义时写了profiles_params（多了s）、profile_param（少了s），和调用处的名字对不上。
• 根本没有定义profile_params这个强参数方法，或者定义时不小心加了self.前缀变成了类方法，实例动作里调用不到。

按下面的步骤一步步写，不会出问题：

1. 路由配置 #

修改config/routes.rb，用单资源路由匹配用户唯一的个人资料，不需要传id参数，天然和当前登录用户绑定：

Rails.application.routes.draw do
  # 你自己的其他路由，比如登录、首页这些
  resource :profile, only: [:show, :edit, :update]
end

配置完可以跑rails routes在终端看，会生成三个对应路由：资料展示页、编辑页、更新提交接口。

2. 控制器代码 #

修正app/controllers/profile_controller.rb，注意不要在类层级直接调用任何实例方法：

class ProfileController < ApplicationController
  # 登录校验，没登录的用户不能访问资料接口，用devise的话直接用这个方法，自己写鉴权的话替换成自己的前置方法
  before_action :authenticate_user!
  before_action :set_profile, only: [:show, :edit, :update]

  # 个人资料展示页
  def show
  end

  # 资料编辑页
  def edit
  end

  # 处理资料更新提交
  def update
    if @profile.update(profile_params)
      redirect_to profile_path, notice: "个人资料修改成功"
    else
      render :edit, status: :unprocessable_entity
    end
  end

  private
  # 加载当前登录用户对应的资料，避免越权修改别人的资料
  def set_profile
    # 如果你的手机号等资料字段直接存在User表，就写@profile = current_user
    # 如果有独立的Profile模型关联User，就写下面这行
    @profile = current_user.profile
  end

  # 强参数配置，统一放在private域下，只允许白名单内的字段提交
  def profile_params
    # 字段存在User表就用:user做require键，独立Profile模型就换成:profile
    params.require(:user).permit(:phone, :nickname, :avatar)
  end
end

注意：如果你的手机号字段存在User表，记得给User模型加上手机号格式、唯一性校验，避免脏数据存入数据库。

3. 视图层代码 #

创建编辑页视图app/views/profile/edit.html.erb，带错误提示和表单：

<h1>修改个人资料</h1>
<!-- 错误提示区 -->
<% if @profile.errors.any? %>
  <div style="color: red;">
    <ul>
      <% @profile.errors.full_messages.each do |msg| %>
        <li><%= msg %></li>
      <% end %>
    </ul>
  </div>
<% end %>

<!-- 资料修改表单 -->
<%= form_with model: @profile, url: profile_path, method: :patch do |f| %>
  <div>
    <%= f.label :phone, "手机号" %>
    <%= f.telephone_field :phone, placeholder: "请输入11位手机号" %>
  </div>
  <div>
    <%= f.label :nickname, "昵称" %>
    <%= f.text_field :nickname %>
  </div>
  <div>
    <%= f.submit "保存修改" %>
  </div>
<% end %>

最后核对检查清单 #

改完如果还有问题，对着一条条核对：

• 检查profile_params的定义有没有拼写错误，有没有误加self.变成类方法
• 检查所有对profile_params的调用是不是都写在def update实例方法内部，没有飘在类的直接层级
• 检查表单提交的参数键名和profile_params里require的键名一致
• 检查set_profile方法拿到的确实是当前登录用户的资料，没有出现越权查询

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