概要

reqwestなど、OpenSSLに依存しているcrateを使用する際、OpenSSL起因でビルドが失敗するなら、rustls-tlsを使うことで回避できるかもしれない。

# Cargo.toml
reqwest = { version = "0.12.7", default-features = false, features = [
    "rustls-tls",
] }

課題

RustでWeb開発をしていると、HTTPクライアントであるreqwestクレートをしばしば使用する。
しかし、reqwestはOpenSSL(クレート名だとopenssl-sysなど)に依存しており、ローカル開発環境や、採用したいDockerイメージによっては、下記のようなエラーにより、ビルドやバイナリの実行に失敗してしまう。

error: failed to run custom build command for `openssl-sys v0.9.103`

error while loading shared libraries: libssl.so.3: cannot open shared obj
ect file: No such file or directory

解決策

Cargo.tomlに下記の通り記載する。

# Cargo.toml
reqwest = { version = "0.12.7", default-features = false, features = [
    "rustls-tls",
] }

ポイントは2つ。

default-features = false: reqwestはデフォルトでnative-tls(こいつはopenssl-sysに依存)に依存しているようなので、明示的にdefault-featuresを無効にする。
featuresでrustls-tlsを指定: featuresに指定するだけで、native-tlsの代わりにrustls-tlsに依存してくれる。rustls-tlsは純粋なRust実装なので、共有ライブラリなどは不要。

経緯

解決策の方向性は2種類思いつく。

OpenSSLの依存関係を用意する
OpenSSLへの依存をやめる

本記事は主に2.OpenSSLへの依存をやめる方法について記述した。
1のアプローチも至って真っ当だが、筆者は苦しんだ果、2に行き着いた。

1の苦しみ

必要なライブラリがどれなのかわからない
- apt-get install libssl-devはまだしも、``
必要なライブラリを入れるためのツールがわからない
必要なライブラリを入れても、環境によってはOpenSSLのインストールに失敗する
OpenSSLのインストールに成功しても、Dockerのマルチステージングビルドで、ビルドしたRustのバイナリ以外にどのバイナリが必要なのかわからない
- ldd(Macならotool)で共有ライブラリは調べられるけど、不足していることもある

2の応用

Cargo.lockをgrepして、opensslに依存しているcrateがあれば、rustls-tlsに変更できないか、クレートのfeaturesを調べてみる。など。

筆者は実際に、google-cloud-stargeというクレートを使っているときに、本エラーに遭遇した。
結局、google-cloud-storageがreqwestに依存していたので、google-cloud-storageのfeaturesを調べて、本記事の解決策と同様にして対応し解決した。

参考