Error
Error Code:
304
MongoDB Error 304: Shard Targeting Invalidated
Description
This error indicates that a `mongos` router or shard member has outdated information about the sharded cluster's configuration. It occurs when an operation targets a shard based on stale metadata, leading to an invalid or unavailable target. This can happen after cluster reconfigurations or network inconsistencies.
Error Message
Shard Invalidated For Targeting
Known Causes
4 known causesStale Configuration Metadata
A `mongos` instance or shard primary holds outdated metadata regarding the cluster's sharding configuration, such as chunk ownership or shard status.
Shard Reconfiguration Event
Recent changes to the sharded cluster, like adding/removing a shard or modifying replica set members, have not yet propagated consistently across all `mongos` instances.
Network Partitions or Latency
Intermittent network issues prevent `mongos` instances from refreshing their configuration cache from the config servers, leading to inconsistent views of the cluster.
Long-Lived Stale Connections
Client applications maintain connections to a `mongos` instance that has stale metadata, causing subsequent operations through that connection to fail.
Solutions
Coming SoonGeneral Troubleshooting Tips
- Check the error message carefully for specific details
- Review recent changes that might have caused the error
- Search for the exact error code in the official documentation
- Check log files for additional context
- Try restarting the application or service