部署生产环境时ActiveRecord迁移报datetime类型宽度错误求助

问题背景 #

相同的Rails迁移文件在预发布服务器执行正常，但生产环境执行bundle exec rake db:migrate时触发以下错误：

TinyTds::Error: Column, parameter, or variable #6: Cannot specify a column width on data type datetime.

迁移文件未显式指定datetime字段的宽度参数，技术栈为Ruby 3.2.0、Rails 7、activerecord-sqlserver-adapter-7.0.2.0。

原因分析 #

1. SQL Server版本差异：旧版SQL Server（如2008及更早）不支持给datetime类型指定宽度，若适配器在生产环境错误生成带宽度参数的SQL语句，就会触发该错误；预发布环境可能使用了支持datetime2类型的新版SQL Server，因此无报错。
2. 适配器配置/版本不一致：预发布与生产环境的activerecord-sqlserver-adapter版本或数据库配置不同，导致SQL生成逻辑存在差异。

解决方案 #

1. 显式使用datetime2类型（推荐） #

修改迁移文件，将所有t.datetime替换为t.datetime2。SQL Server的datetime2是更现代的时间类型，支持精度配置且不会触发宽度参数错误：

class CreateTenpoContractDetails < ActiveRecord::Migration[7.0]
  def change
    create_table :tenpo_contract_details do |t|
      t.string    :payment_payee
      t.datetime2 :tenpo_start_date
      t.datetime2 :tenpo_end_date
      t.datetime2 :next_yoyaku_date
      t.datetime2 :tenpo_open_date
      t.datetime2 :tenpo_agreement_date
      t.datetime2 :contract_expiration_date
      t.datetime2 :contract_start_period
      t.datetime2 :contract_end_period
      t.integer   :total_contract_period
      t.integer   :revise_number_of_year
      t.datetime2 :condition_revision_schedule_date
      t.timestamps
    end
  end
end

2. 全局配置适配器默认datetime类型 #

在config/database.yml的生产环境配置中添加datetime_type: datetime2，让适配器默认将Rails的datetime类型映射为SQL Server的datetime2：

production:
  adapter: sqlserver
  # 其他已有配置（如database、username、password等）
  datetime_type: datetime2

3. 统一环境版本与配置 #

• 确认预发布和生产环境的SQL Server版本一致，若生产环境为旧版，可考虑升级至支持datetime2的版本；
• 同步两边的activerecord-sqlserver-adapter版本，避免版本差异导致的SQL生成逻辑不一致。

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