如何在Elixir1.6+Phoenix1.3+MySQL5.5中用Ecto插入空值到文本字段

我之前处理过类似的场景，大概率是Ecto的Schema约束、迁移配置或者MySQL的SQL_MODE这几个环节出了问题，下面分点给你具体的排查和解决方法：

1. 对齐Ecto Schema与数据库字段的一致性 #

虽然你手动在MySQL里把字段设为nullable，但如果Ecto的迁移文件或Schema隐含了非空约束，会先在应用层面触发校验，根本到不了MySQL执行步骤：

• 检查你的Schema定义，确保字段没有强制非空：

  # 正确的允许空值的字段写法（默认就是nullable: true）
  schema "your_table" do
    field :target_text_field, :string
    # 若之前加了:not_null约束，需要移除：field :target_text_field, :string, not_null: false
  end
  

• 同步迁移文件配置，确保迁移里显式允许空值：

  alter table("your_table") do
    add :target_text_field, :string, null: true  # 显式声明避免歧义
  end
  

  如果之前迁移用了null: false，建议重新执行迁移或者手动同步数据库字段结构。

2. 区分nil与空字符串的处理逻辑 #

Ecto会把nil转为MySQL的NULL，空字符串""则直接插入为''，两者的处理逻辑可能触发不同的校验：

• 如果想把空字符串统一转为nil插入，可以在changeset里处理：

  def changeset(struct, params) do
    struct
    |> cast(params, [:target_text_field])
    |> convert_empty_string_to_nil(:target_text_field)
    # 其他业务校验...
  end
  
  defp convert_empty_string_to_nil(changeset, field) do
    case get_change(changeset, field) do
      "" -> put_change(changeset, field, nil)
      _ -> changeset
    end
  end
  

• 如果业务允许空字符串，要确保Ecto没有加validate_length(min: 1)这类限制，MySQL文本字段默认是支持空字符串的。

3. 调整MySQL的SQL_MODE设置 #

MySQL 5.5默认的SQL_MODE可能包含STRICT_TRANS_TABLES，这个严格模式下，即使字段允许空值，某些不符合规则的插入（比如编码异常的空值）也会触发错误：

• 先查看当前SQL_MODE：

  SELECT @@SQL_MODE;
  

• 临时关闭严格模式测试是否解决问题：

  SET GLOBAL SQL_MODE = 'NO_ENGINE_SUBSTITUTION';
  

• 如果有效，建议把配置写入MySQL的my.cnf（或my.ini）文件，避免重启后失效：

  [mysqld]
  sql_mode = NO_ENGINE_SUBSTITUTION
  

  注意：关闭严格模式前要评估业务影响，若需要保留其他校验规则，可以只移除STRICT_TRANS_TABLES项。

4. 检查Ecto的验证规则 #

如果你的changeset里加了validate_required([:target_text_field])，不管MySQL字段是否允许空值，Ecto都会在插入前拦截nil或空值：

• 若字段是可选的，直接移除该验证；
• 若允许空字符串但不允许nil，可以调整校验逻辑：

  validate_length(changeset, :target_text_field, min: 0, allow_nil: false)
  

排查时可以开启Ecto的SQL日志，查看实际执行的SQL语句，快速定位是Ecto层面的校验错误还是MySQL返回的错误：

# 在config/dev.exs中开启SQL日志
config :your_app, YourApp.Repo,
  log: :debug

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