PAYATHON 2026

Rails ActiveStorage 在 OpenSSL 3.x 下 MD5 初始化失败

技术问小赵

先说结论:这通常不是 Rails 7/8 和 AlmaLinux 10 的版本不兼容,问题更可能出在 OpenSSL 3.x 的 provider 或系统 crypto policy,导致 OpenSSL::Digest::MD5 无法初始化。ActiveStorage 默认用 MD5 计算 blob checksum,因此上传文件会在 assign_attributes 阶段失败。先确认 MD5 不可用是 OpenSSL 配置、crypto policy 还是 FIPS 模式造成的,再决定是启用 MD5,还是加兼容补丁。

先定位问题

在 Rails 进程使用的同一个 Ruby/OpenSSL 环境里执行:

ruby -ropenssl -e 'puts OpenSSL::OPENSSL_VERSION; p OpenSSL::Digest::MD5.hexdigest(%q(hello))'

如果这里报 Digest initialization failed,再检查 OpenSSL 命令行是否也失败:

openssl version -d
openssl list -providers
openssl list -digest-algorithms | grep -i md5
printf 'hello' | openssl dgst -md5
update-crypto-policies --show

如果命令行也失败,说明问题在 OpenSSL 层;如果只有 Ruby 失败,重点看 Ruby 进程实际加载的 OpenSSL 配置和 provider。AlmaLinux/RHEL 上的 OpenSSL 配置目录不一定是 /etc/ssl,先用 openssl version -d 查看 OPENSSLDIR,常见路径是 /etc/pki/tls。

推荐做法:只给 Rails 进程单独提供 OpenSSL 配置

先不要改全系统策略。可以新建一个只给 Rails/Ruby 进程使用的配置,启用 default provider 和 legacy provider:

sudo tee /etc/pki/tls/openssl-rails.cnf >/dev/null <<'EOF'
openssl_conf = openssl_init

[openssl_init]
providers = provider_sect

[provider_sect]
default = default_sect
legacy = legacy_sect

[default_sect]
activate = 1

[legacy_sect]
activate = 1
EOF

测试:

OPENSSL_CONF=/etc/pki/tls/openssl-rails.cnf ruby -ropenssl -e 'p OpenSSL::Digest::MD5.hexdigest(%q(hello))'

正常应输出:

5d41402abc4b2a76b9719d911017c592

确认可用后,只把 OPENSSL_CONF 加到 Rails 服务环境。以 systemd 为例:

sudo systemctl edit rails-app.service

加入:

[Service]
Environment=OPENSSL_CONF=/etc/pki/tls/openssl-rails.cnf

然后重启服务。这样只影响该 Rails 进程,不会放宽整台机器的弱算法策略。

如果系统策略或 FIPS 禁用了 MD5

update-crypto-policies --show 显示 FIPS 时,MD5 不可用是设计行为。生产环境不要为了 ActiveStorage 强行绕过 FIPS;应改用非 FIPS 环境,或者评估修改 ActiveStorage 对 MD5 的依赖。

如果只是临时验证,可以测试切换 crypto policy,但不建议长期使用宽松策略:

sudo update-crypto-policies --set LEGACY
sudo reboot

验证后应恢复到组织要求的安全策略。

不能改 OpenSSL 时的兼容补丁

如果暂时不能调整 OpenSSL,又必须保留 MD5 算法,可以让 ActiveStorage 的 checksum 计算改用 Ruby 标准库 Digest::MD5。先确认标准库可用:

ruby -rdigest/md5 -e 'puts Digest::MD5.hexdigest(%q(hello))'

然后在 Rails 初始化器里加兼容补丁:

# config/initializers/active_storage_md5_workaround.rb
require 'digest/md5'

module ActiveStorageMd5Workaround
  private

  def compute_checksum
    self.checksum = Digest::MD5.base64digest(io.read)
    io.rewind
  end
end

ActiveStorage::Blob.prepend(ActiveStorageMd5Workaround)

注意:这个补丁只覆盖 ActiveStorage 在服务端计算 blob checksum 的路径,修不了其他直接调用 OpenSSL::Digest::MD5 的代码;不同 Rails 小版本的 compute_checksum 实现可能不同,上线前要对照当前版本源码测试。它保留 MD5 算法,所以不会改变已有 checksum 的语义;不要随意换成 SHA256,否则直传前端、已有数据和服务端校验都可能不一致。

结论和注意事项

Rails 7/8 可以在 OpenSSL 3.x 上运行。当 MD5 被 provider、crypto policy 或 FIPS 禁用时,ActiveStorage 依赖 MD5 checksum 的问题才会暴露出来。优先用进程级 OpenSSL 配置启用 MD5;如果合规要求不允许 MD5,就应改造 ActiveStorage 的 checksum 逻辑,而不是简单把系统切到 LEGACY。AlmaLinux 10 本身不必因此被判定为与 Rails 7/8 完全不兼容。

备注:内容仅供参考。