Rails secrets.yml读取含换行符环境变量报错如何解决

问题复现 #

项目初始config/secrets.yml配置如下：

development:
  app_name: MyApp
  secret: <%= ENV['SECRET_VALUE'] %>

给SECRET_VALUE赋值含换行的内容时：

export SECRET_VALUE=$(printf "hello\nworld")

启动Rails会直接抛出YAML解析错误：

/usr/local/lib/ruby/3.0.0/psych.rb:457:in 'parse': (<unknown>): could not find expected ':' while scanning a simple key at line 4 column 1 (Psych::SyntaxError)

核心原因是Rails加载YAML配置时会先执行ERB插值，再做YAML解析，环境变量里的换行符会直接插入YAML文本，破坏原有结构。
之前尝试的外层包双引号写法：

development:
  app_name: MyApp
  secret: "<%= ENV['SECRET_VALUE'] %>"

虽然能绕过语法错误，但YAML解析双引号包裹的普通字符串时，会自动把未转义的换行替换为空格，最终读取到的secret值为hello world，换行符丢失，不满足业务要求。
手动给环境变量拼接YAML多行标记|的写法虽然能跑，但需要在所有设置环境变量的地方适配YAML语法，耦合度太高，非常不优雅。

推荐方案 #

方案1：ERB层做转义适配（零依赖，兼容所有Rails版本） #

直接在ERB插值阶段把字符串里的真实换行替换为YAML双引号语法识别的转义换行，不需要修改任何环境变量的赋值逻辑：

development:
  app_name: MyApp
  secret: "<%= ENV['SECRET_VALUE']&.gsub("\n", "\\n") %>"

这里加&.是为了兼容环境变量未设置的场景，避免抛出空指针错误。
验证结果：

irb(main):001:0> puts ENV['SECRET_VALUE']
hello
world
=> nil
irb(main):002:0> puts Rails.application.secrets[:secret]
hello
world
=> nil

换行符完整保留，也不会触发YAML语法错误。

方案2：ERB层自动处理YAML多行缩进 #

如果偏好YAML多行块的写法，可以在ERB里自动处理每行的缩进，不需要在环境变量侧做任何适配：

development:
  app_name: MyApp
  secret: |
    <%= ENV['SECRET_VALUE']&.lines&.map { |l| "  #{l}" }&.join&.chomp %>

注意拼接的缩进空格数要比secret所在行多2个，符合YAML多行语法的缩进规则即可，解析后同样能完整保留所有换行。

方案3：升级使用Rails原生Credentials（Rails 5.2+支持） #

如果项目使用Rails 5.2及以上版本，建议直接弃用旧的secrets机制，改用Rails原生的credentials管理敏感配置。该机制本身对多行值有完善的支持，直接通过rails credentials:edit写入带换行的密钥即可，完全不需要处理ERB插值和YAML转义的问题，长期维护成本最低。

注意：不要在环境变量赋值阶段拼接YAML语法标记，这种写法会把配置文件的解析逻辑泄露到环境变量层，切换部署环境、换用其他启动脚本时很容易因为格式不兼容触发问题。

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