Quand la synchro de l’iCloud Drive bloque…

Quand vous constatez que l’iCloud Drive ne se met pas à jour sur un de vos Mac, vous pouvez trouver sur Internet des dizaines de conseils, solutions, bidouilles pour « réveiller » la synchronisation. On y trouve à manger et à boire.
Voici une solution qui a fonctionné pour moi – je ne garantis évidemment pas qu’elle marchera pour vous si vous êtes conduit à la mettre en œuvre.

J’ai deux MacBook Air, un M2 sous macOS 26 Tahoe, sur lequel je travaille ; un autre, à proceseur Intel de 2020, sous macOS 15 Sequoia. L’autre jour, j’ai créé, sur le M2, un dossier dans iCloud Drive et j’y ai glissé un fichier servant à une application que je souhaite utiliser avec la même base de données sur les deux machines. 
Plus tard dans la soirée, face au Mac Intel, j’ai constaté que, malgré plusieurs heures passées, l’iCloud Drive « local » n’avait pas été mis à jour.
La synchronisation n’avait pas fonctionné de toute la journée. C’était peut-être le cas depuis longtemps, mais je n’en avais pas eu besoin.
Je voyais par ailleurs très bien l’iCloud Drive sur l’iPad et sur l’iPhone.

La manœuvre que j’ai tentée a remis ma synchronisation en ordre de marche. Ce n’est pas compliqué ni dangereux pour votre configuration. 

Il y a de plus au moins trois façons d’obtenir la même chose.

Cette solution doit être uniquement effectuée que sur une machine dont la synchronisation iCloud est problématique, incomplète, sans aucun doute corrompue, la machine sur laquelle il manque des fichiers pourtant présents sur l’iCloud Drive. On ne la déclenche jamais sur une machine qui est parfaitement synchronisée.

J’y suis allé « à la main »

Sur le Mac Intel sous Sequoia qui était bloqué, je suis allé dans la Bibliothèque (utilisateur) > Application Support pour trouver le dossier CloudDocs. Je l’ai jeté à la corbeille ; j’ai vidé cette dernière ; j’ai redémarré le MacBook. 


Dès le retour sur le Finder, la synchronisation de l’iCloud Drive est repartie de plus belle et j’ai retrouvé tous mes fichiers, y compris le dossier que j’y avais créé et son contenu.

Le dossier CloudDocs, qui avait sans doute été corrompu, a été automatiquement recréé par le système, avec des données nouvelles.

Par le Terminal

On peut aussi « moins brutalement », passer par le Terminal, taper la commande suivante :

killall bird
rm -rf ~/Library/Application\ Support/CloudDocs
launchctl kickstart -k gui/$UID/com.apple.bird

… puis redémarrer le Mac et vérifier que l’iCloud Drive synchronise à nouveau.

La procédure que recommande Apple

Enfin, l’approche recommandée par Apple est de désactiver iCloud Drive : Réglages système > Identifiant Apple > iCloud > décocher iCloud Drive. Il est proposé de conserver une copie locale ou de la supprimer ; le miroir local étant incomplet, ce n’est pas la peine de sauvegarder.
La désactivation étant effectuée, on redémarre le Mac.
La procédure revient à arrêter puis à relancer le daemon bird ainsi que les services liés.
Le Mac de nouveau opérationnel, il faut retourner dans les Réglages pour réactiver iCloud Drive. macOS recrée dans la foulée le dossier CloudDocs et télécharge un nouvel état depuis les serveurs Apple.
C’est peut-être un peu moins cavalier que ce que j’ai fait, mais c’est un peu plus laborieux.

Vous avez le choix des armes.