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 完全不兼容。
备注:内容仅供参考。
