Secure Rust Guidelines 日本語訳 誤訳を知らせる
安全な Rust アプリケーション開発の指針エラー処理
  1. はじめに
  2. 開発環境
  3. ライブラリ
  4. 命名
  5. 整数演算
  6. エラー処理
  7. 言語の保証
  8. unsafe Rust: 概論
  9. unsafe Rust: メモリ管理
  10. unsafe Rust: FFI
  11. 標準ライブラリ
  12. 規則と推奨の一覧

エラー処理

失敗しうる関数を扱う方法としては、Result 型を使うのが望ましい。 Result オブジェクトは必ず検査しなければならず、決して無視してはならない。

クレートは、起こりうるすべてのエラーをラップする独自の Error 型を実装してもよい。 その際は、この型を例外安全(RFC 1236)にし、 Error + Send + Sync + 'static と Display を実装するよう注意しなければならない。

エラー処理を楽にするために、サードパーティのクレートを使ってもよい。その多く (特に snafu や thiserror)は、必要なトレイトを実装し、ほかのエラーを ラップできる独自のエラー型を新たに作ることを目的としている。

もう一つの方法(特に anyhow クレートが提案しているもの)は、エラーを単一の 汎用エラー型へ自動的にラップするものである。このようなラッパーは、ラップした エラーに開発者が文脈を与えられないため、ライブラリや複雑なシステムでは 使うべきでない。

パニック

一般に、panic を呼び出すよりも、明示的なエラー処理(Result)を優先すべきである。 エラーの原因が分かるようにすべきであり、汎用的なエラーは 避けるべきである。

Rust の関数は、その使用条件に違反した場合を除き、パニックしてはならない。

ライブラリを提供するクレートは、失敗してコードをパニックさせうる関数や命令を 決して使うべきでない。

次のパターンは(設計上)パニックを引き起こしうる。

次の規則は、前の規則から導かれる。

unwrap、expect、assert! の使用は、関数の仕様が明示的に禁じている場合に限定しなければならない。

次の操作は、引数が使用条件を満たさない場合にパニックすることが知られている。

配列の添字アクセスは適切に検査しなければならない。または、Option を返す get メソッドを使うべきである。

安全性が重視される(セーフティクリティカルな)一部の分野では、放置すれば未定義動作につながりうるエラーが発生した場合、必ずセーフモード状態へ移行することが義務づけられている。 このような状況では、実行を意図的に中断することは理にかなっている。破損したデータや安全上の障害が広がる前にシステムを止められるからである。

航空機やその他の乗り物では、この「フェイルファスト(早期に失敗させる)」動作が極めて重要になりうる。主制御装置は、重大な障害が起きたら直ちに停止し、冗長系またはバックアップのサブシステムに制御を引き渡さなければならない。引き継いだサブシステムは、機体を安全に停止させるか、機能を縮退させたモードで運用を続ける。信頼できる二次系で再起動することで、航空機を制御可能な状態に保ち、搭乗者を守り、予測できない状態のまま実行を続けることで生じうる危険な結果を防げる。

この用途では、Cargo.toml ファイルの [profile.release] セクションで panic = 'abort' 属性を有効にすると、パニックが発生した時点でプログラムが直ちに終了する。

FFI とパニック

Rust へのほかの言語の統合は、FFI(Foreign Function Interface)を通じて行う。 この機能については、専用の章で詳しく説明する。