{
  "id": "P229",
  "slug": "mongodb-8-0-direct-connection-to-shard-improper-sharded-cluster-error-use-mongos-backup-tool-sha",
  "status": "search-observed",
  "product": "MongoDB 8.0",
  "family": "Database operational contract",
  "canonical_url": "https://gitdocs.org/fix/mongodb-8-0-direct-connection-to-shard-improper-sharded-cluster-error-use-mongos-backup-tool-sha",
  "query_alias_url": "https://gitdocs.org/q/mongodb-8-0-direct-connection-to-shard-improper-sharded-cluster-error-use-mongos-backup-tool-sha",
  "markdown_url": "https://gitdocs.org/fix/mongodb-8-0-direct-connection-to-shard-improper-sharded-cluster-error-use-mongos-backup-tool-sha.md",
  "json_url": "https://gitdocs.org/api/fixes/mongodb-8-0-direct-connection-to-shard-improper-sharded-cluster-error-use-mongos-backup-tool-sha.json",
  "canonical_query": "MongoDB 8.0 direct connection to shard improper sharded cluster error use mongos backup tool shard direct command",
  "observed_codex_queries": [
    "MongoDB 8.0 direct connection to shard improper sharded cluster error use mongos backup tool shard direct command",
    "site:mongodb.com/docs/manual MongoDB 8.0 connect directly to shard mongos",
    "MongoDB sharded cluster do not connect directly to shard mongos documentation",
    "https://www.mongodb.com/docs/manual/core/sharded-cluster-query-router/",
    "'Applications never connect or communicate directly with the shards.' in https://www.mongodb.com/docs/manual/core/sharded-cluster-query-router/"
  ],
  "organic_dependency_search_count": 5,
  "affected_versions": "",
  "exact_errors": [],
  "diagnosis": "The local schema/query is valid, but upgrade path, restart behavior, replication syntax, or background operations changed in the server release.",
  "before": "",
  "after": "",
  "verification": "Verifier checks durability, restart, and operational safety rather than a one-shot query. Check durability, topology-safe routing, and monitoring meaning.",
  "unsafe_fixes": [
    "Changing local code without checking the current external contract.",
    "Retrying the same install, build, or API call with no version/source change.",
    "Applying a broad unsafe bypass when a narrow compatibility fix is available."
  ],
  "last_verified_at": "2026-06-25",
  "neutral_validation": {
    "organic_search_observed": true,
    "organic_strict_pass": true,
    "no_web_counterfactual_run": false,
    "no_web_strict_pass": null,
    "search_necessity_under_fixture": null,
    "no_web_oracle_note": "Observed query evidence is separated from necessity proof; no-web and stale-contract counterfactuals should be tracked separately."
  },
  "source_trail": [
    {
      "url": "https://www.mongodb.com/docs/manual/release-notes/8.0-compatibility/",
      "label": "MongoDB 8.0 compatibility changes"
    },
    {
      "url": "https://www.mongodb.com/docs/manual/core/sharded-cluster-query-router/",
      "label": "Official reference opened by Codex"
    }
  ],
  "source_github_links": []
}
