接続のトラブルシューティング

接続stringを確認する

接続stringのホスト名とポート番号が両方とも正確であることを確認してください。 MongoDB インスタンスのデフォルトのポート値は27017ですが、MongoDB を別のポートで通信するように構成できます。

ファイアウォールを構成する

MongoDB 配置がリッスンするポートが同じネットワーク上のファイアウォールによってブロックされていないことを確認します。 MongoDB はデフォルトでポート27017を使用します。 MongoDB が使用するデフォルトのポートとその変更方法について詳しくは、「デフォルトの MongoDB ポート 」を参照してください。

接続stringを確認する

無効な接続stringは、接続文字列と SCRAM-SHA-256 または SCRAM-SHA-1 を使用してMongoDBに接続しようとする際に発生する最も一般的な原因です。

string接続文字列にユーザー名とパスワードが含まれている場合は、それらが正しい形式であることを確認してください。ユーザー名またはパスワードに次の文字のいずれかが含まれている場合、パーセント エンコードされている必要があります。

: / ? # [ ] @

次の例は、"#MyPassword?" をパーセント エンコードする方法を示しています。

Console.WriteLine(System.Web.HttpUtility.UrlEncode("#MyPassword?"));

これにより、次の出力が得られます。

%23MyPassword%3F

MongoClientSettings プロパティを確認する

MongoDB 配置に接続しようとする際に、 MongoClientSettingsオブジェクトを使用して設定を構成できます。 Credentialプロパティを使用して認証情報を設定できます。 認証情報が正しくない場合、MongoDB 配置に接続しようとすると認証エラーが発生します。

認証データベースでユーザーが であることを確認

SCRAM-SHA-256またはSCRAM-SHA-1でユーザー名とパスワードを使用して接続を正常に認証するには、認証データベースにユーザー名を定義する必要があります。 デフォルトの認証データベースはadminデータベースです。 認証に別のデータベースを使用するには、 接続stringで authSource オプションを指定します。 次の例では、認証データベースとしてusersを使用するようにドライバーに指示しています。

using MongoDB.Driver;
// Connection URI
const string connectionUri = "mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=users";
// Create a new client and connect to the server
var client = new MongoClient(connectionUri);

また、 MongoClientSettingsオブジェクトを作成し、それをMongoClientコンストラクターに渡すことで構成設定を設定することもできます。 Credentialプロパティを使用して、認証データベースの指定を含むログイン認証情報を設定できます。 MongoClientSettingsの使用の詳細と例については、「 MongoClientSettings の使用 」を参照してください。

これが問題であるかどうかは、同じコードを使用してローカルマシンでホストされている MongoDB インスタンスに接続しようとすることで確認できます。 同じマシン上の配置では、接続するための認可は必要ありません。

ディスク上の証明書の作成と保存

次のコードを使用して、アプリケーションに必要なX.509証明書を生成します。

using (X509Certificate2 certWithKey = certOnly.CopyWithPrivateKey(key))
{
   return new X509Certificate2(certWithKey.Export(X509ContentType.Pkcs12));
}

ユーザー権限の確認

正しいユーザーが MongoDB 配置にアクセスしたことを確認します。 エラー内の「メッセージ」というタームは、ドライバーによって送信されたコマンドである場合があります。 コマンドを送信する権限を持たないユーザーを使用している場合、ドライバーはこのエラーを生成する可能性があります。

また、ユーザーが送信するメッセージに対する適切な権限を持っていることも確認します。 MongoDB は、RBAC（Role-Based Access Control、ロールベースのアクセス制御）を使用して、MongoDB 配置へのアクセスを制御します。 MongoDB で RBAC を構成する方法の詳細については、「ロールベースのアクセス制御 」を参照してください。

ファイアウォールを構成する

ファイアウォールは MongoDB インスタンスと通信するためにオープンなポートが必要です。 ファイアウォールの構成の詳細については、「 接続エラー 」セクションの「 ファイアウォールを構成する 」を参照してください。

接続数の確認

各MongoClientインスタンスは、接続プール内で同時にオープンする接続の最大数をサポートします。 この制限を定義するパラメータMaxConnectionPoolSizeを構成できます。 デフォルト値は100です。 すでに開いている接続の数がMaxConnectionPoolSizeに等しい場合、サーバーは接続が利用可能になるまで待機します。 この待機時間がMaxConnectionIdleTimeの値を超えると、ドライバーはエラーで応答します。

接続プーリングの機能方法について詳しくは、「 .NET/C# ドライバーで接続プーリングがどのように機能しますか 」を参照してください。 FAQ に記載されています。

接続数の確認

よりオープンな接続を作成する必要がある場合は、 MaxConnectionPoolSizeを増やします。 接続数の確認の詳細については、「 メッセージの送信エラー 」セクションで「 接続数を確認する 」を参照してください。

connectTimeoutMS の設定

ドライバーが到達不能なレプリカセット ノードに到達するのに時間がかかりすぎるため、接続を確立できない場合、ドライバーがハングすることがあります。 connectTimeMS設定を使用すると、ドライバーが接続を確立するために費やす時間を制限できます。 この設定の詳細については、サーバー マニュアルの「タイムアウト オプション 」を参照してください。

connectTimeoutMSの設定が、 のノードに対する最高のネットワーク レイテンシよりも低くないことを確認する必要があります。 セカンダリ ノードの 1 つのレイテンシが 10000 ミリ秒の場合、 connectTimeoutMSを 9000 に設定すると、ドライバーはそのノードに接続できなくなります。

このオプションは 接続stringに設定できます。 次の例では、 connectTimeoutMSを 10000 ミリ秒に設定しています。

using MongoDB.Driver;
// Connection URI
const string connectionUri = "mongodb://<db_username>:<db_password>@<hostname>:<port>/?connectTimeoutMS=10000";
// Create a new client and connect to the server
var client = new MongoClient(connectionUri);

また、 MongoClientSettingsオブジェクトを作成し、それをMongoClientコンストラクターに渡すことで構成設定を設定することもできます。 MongoClientSettingsの使用の詳細と例については、「 MongoClientSettings の使用 」を参照してください。

接続数の確認

サーバーへの接続数がMaxConnectionPoolSizeを超える可能性があります。 接続数の確認の詳細については、「 メッセージの送信エラー 」セクションで「 接続数を確認する 」を参照してください。