When a document's shard key is modified in such a way that the document remains on the same shard¹, the corresponding oplog entry will be an update with the documentKey of the pre-image, rather than the post-image. This is necessary because if we were to record the post-image documentKey instead, there would be no robust way² to identify which document was actually modified.

However, one consequence of this behaviour is that if the user has requested updateLookup, it will use the pre-image documentKey, and will therefore fail to find the document. In the worst case, if the chunk containing the original pre-image shard key is moved off the shard and a new document which matches the pre-image documentKey is inserted on the new shard, updateLookup will return an unrelated document while the original document still exists in the cluster.

To fix this, we could record the post-image documentKey in the oplog as well as the pre-image key, or we could apply the update to the documentKey to produce the post-image key before performing the updateLookup.

¹ This issue does not manifest in cases where the shard-key modification causes the document to move from one shard to another, since that results in a delete on the original shard and an insert on the new shard.

² Technically, since this only occurs when the document stays on the same shard after its shard key is modified, it would be possible to identify the pre-image by _id alone - at least, as long as the document continues to remain on that shard. However, since the documentKey is considered the unique identifier of a particular document in all other cases, it is not reasonable to expect users to know that in this obscure scenario they should ignore the shard keys and consider only the _id.