Rails应用遇PG::UndefinedTable错误：csv_uploads表不存在（迁移已成功）

问题描述 #

访问CsvUploadsController的index页面时触发如下错误：

PG::UndefinedTable: ERROR:  relation "csv_uploads" does not exist
LINE 10:  WHERE a.attrelid = '"csv_uploads"'::regclass
^

已完成以下排查但问题未解决：

• 创建csv_uploads表的CreateCsvUploads迁移已成功执行，状态显示为up
• 执行过rails db:migrate、rails db:reset、rails db:drop db:create db:migrate等命令
• 通过psql的\dt命令确认PostgreSQL数据库中存在csv_uploads表
• schema.rb文件已包含该表的完整定义
• 清除过Rails缓存并重启过服务器

环境：PostgreSQL数据库，Rails 7.x版本

相关代码 #

迁移文件

class CreateCsvUploads < ActiveRecord::Migration[7.1]
  def change
    create_table :csv_uploads do |t|
      t.string :file_name
      t.string :upload_type
      t.text :validation_errors, default: "[]"
      t.timestamps
    end
  end
end

CsvUpload模型

class CsvUpload < ApplicationRecord
  validates :file_name, presence: true
  validates :upload_type, presence: true
end

CsvUploadsController控制器

class CsvUploadsController < ApplicationController
  def index
    @errors = []
  end

  def create
    uploaded_file = params.dig(:csv_upload, :file)
    type = params.dig(:csv_upload, :type)

    unless uploaded_file&.respond_to?(:original_filename)
      flash[:error] = 'No file uploaded or invalid file format.'
      redirect_to csv_uploads_path and return
    end

    if uploaded_file.original_filename.ends_with?('.csv')
      csv_data = CSV.parse(uploaded_file.read, headers: true)
      @errors = validate_csv(csv_data, type)

      if @errors.any?
        CsvValidation.create(validation_errors: @errors.to_json)
        redirect_to show_validation_errors_csv_uploads_path
      else
        redirect_to csv_uploads_path, notice: "CSV processed successfully."
      end
    else
      flash[:error] = 'Only CSV files are allowed.'
      redirect_to csv_uploads_path
    end
  end

  def show_validation_errors
    @validation_record = CsvValidation.last
    @errors = @validation_record ? JSON.parse(@validation_record.validation_errors) : []
  end

  private

  def validate_csv(csv_data, type)
    case type
    when "Purchase Order"
      PurchaseOrderCheck.new.validate(csv_data)
    when "Order"
      OrderCheck.new.validate(csv_data)
    when "Product"
      ProductCheck.new.validate(csv_data)
    when "Supplier"
      SupplierCheck.new.validate(csv_data)
    else
      ["Invalid type selected."]
    end
  end
end

问题解答 #

1. 为何仍会出现PG::UndefinedTable错误？ #

可能的核心原因：

• 数据库连接配置错误：Rails可能连接到了错误的数据库（比如开发环境误连测试库），检查config/database.yml中的数据库名称、用户名、环境对应关系是否正确。
• 表名大小写与引号问题：PostgreSQL默认区分标识符大小写，错误信息中表名带双引号'"csv_uploads"'，说明Rails生成SQL时错误给表名加了引号，导致PostgreSQL无法匹配实际存在的小写表名。
• 模型表名映射异常：虽然CsvUpload默认对应csv_uploads表，但如果模型中手动设置了self.table_name、存在命名空间干扰，会破坏默认映射规则。
• 进程缓存残留：Spring等进程管理工具可能缓存了旧的数据库结构，即使重启服务器也无法更新。
• 关联模型影响：控制器中调用了CsvValidation.create，如果CsvValidation的表不存在或有异常，可能间接触发关联查询错误（虽然错误信息指向csv_uploads，但仍需排查）。

2. 确保表被Rails应用识别的额外步骤 #

• 验证数据库连接有效性：在Rails控制台执行ActiveRecord::Base.connection.execute("SELECT * FROM csv_uploads LIMIT 1")，若报错则说明连接的数据库确实无此表，重点检查database.yml。
• 确认模型表名映射：控制台执行CsvUpload.table_name确认输出为csv_uploads；执行CsvUpload.connection.table_exists?(:csv_uploads)，需返回true才正常。
• 强制重启Spring进程：执行spring stop后再启动服务器，清除Spring的进程缓存。
• 指定环境启动服务器：明确使用目标环境启动，比如RAILS_ENV=development rails s，避免误连其他环境数据库。
• 强制加载schema：执行rails db:schema:load，直接从schema.rb重建数据库结构，覆盖现有库。

3. 进一步调试建议 #

• 查看生成的SQL日志：在config/environments/development.rb中设置config.log_level = :debug，访问页面后查看日志中的SQL语句，确认是否错误引用了表名（比如多余引号）。
• 检查数据库用户权限：用Rails配置的数据库用户登录psql，执行SELECT * FROM csv_uploads;，若报错则是权限问题，需给用户分配该表的读写权限。
• 排查第三方gem干扰：临时移除非必要的数据库相关gem，重启服务器测试，排除gem修改查询逻辑的可能。
• 确认模型继承关系：检查CsvUpload是否确实继承自ApplicationRecord，避免自定义基类破坏表名映射逻辑。
• 控制台创建测试记录：在Rails控制台执行CsvUpload.create(file_name: "test.csv", upload_type: "Product")，根据报错信息直接定位问题点。

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