Ottieni la sincronizzazione desktop di Nextcloud: oltre la fase di "Elaborazione file"

Se il client desktop di Nextcloud rimane bloccato su "Elaborazione file", apri l'attività di sincronizzazione dell'account e verifica se un file continua a mostrare un errore o se il client sta ancora analizzando una struttura di cartelle di grandi dimensioni. Controlla prima questo aspetto, poi rivedi le regole per i file ignorati e la connessione al server. Il riavvio potrebbe risolvere un blocco temporaneo, ma l'eliminazione del database di sincronizzazione o la ricreazione della connessione di sincronizzazione dovrebbero essere eseguite in un secondo momento, poiché potrebbero reimpostare le scelte di sincronizzazione selettiva o innescare una nuova scansione completa.

Scopri cosa è effettivamente bloccato

Apri il menu di Nextcloud dalla barra delle applicazioni su Windows o Linux, oppure dalla barra dei menu su macOS, e apri lo stato dell'account. Cerca un nome file ripetuto, un errore visibile o una coda che cambia. Il client distingue gli stati di sincronizzazione, pausa, offline, avviso ed errore; un'icona di attività blu non garantisce di per sé che i dati siano in fase di caricamento. Nella modalità di sincronizzazione classica, le sovrapposizioni del file manager possono essere d'aiuto: il blu indica una sincronizzazione in attesa o attiva, un segno di spunta verde indica la sincronizzazione in corso e una X rossa indica un errore. La modalità File virtuali/Provider di file utilizza indicatori di stato del sistema operativo diversi, quindi controlla la finestra del client e i dettagli in Finder o Esplora risorse anziché dare per scontato che si applichino le icone della modalità classica.

Se il numero di elementi in sospeso diminuisce, lascia il client in esecuzione e attendi che la scansione termini, soprattutto dopo aver aggiunto una cartella di grandi dimensioni o aver ricollegato un dispositivo. Se lo stesso elemento rimane in cima alla coda, apri i dettagli dell'errore. Annota il percorso locale e il messaggio esatto prima di spostare, rinominare o modificare qualsiasi elemento. Evita di mettere in pausa e riprendere ripetutamente l'esecuzione mentre la coda si aggiorna; ciò non permette di individuare la causa del problema e può rendere più difficile valutare lo stato di avanzamento.

Verifica le regole relative ai file e ai file ignorati.

Quando un file blocca l'avanzamento, confronta il suo nome, il percorso e lo stato locale con la copia sul server nell'interfaccia web di Nextcloud. Verifica che il file non sia ancora aperto in un editor, in fase di scrittura da parte di una fotocamera o di un programma di backup, oppure bloccato da un altro processo. Se un'applicazione sta modificando attivamente il file, chiudila correttamente e lascia che il client riprovi. Non eliminare nessuna delle due copie solo per cancellare lo stato.

Alcuni file vengono deliberatamente ignorati. Nextcloud esclude determinati file di sistema e nomi che non possono essere rappresentati su altri file system. Nelle impostazioni del client, apri Avanzate → Modifica file ignorati (le etichette possono variare a seconda della versione del client) e rivedi i modelli personalizzati per il nome interessato o la sua cartella principale. Un carattere jolly come *corrisponde a più caratteri; ?corrisponde a un singolo carattere; una barra finale limita un modello alle directory. Rimuovi o restringi una regola personalizzata solo se il file deve essere sincronizzato. Non modificare il file globale sync-exclude.lstfornito con l'applicazione come prima soluzione; Nextcloud avverte che la modifica di questo file può causare comportamenti imprevisti.

Verifica anche lo stato delle cartelle ignorate o non sincronizzate del client e le opzioni di sincronizzazione selettiva. Una cartella esclusa intenzionalmente non verrà sincronizzata solo perché il client viene riavviato. Se il problema riguarda solo un percorso specifico, testare temporaneamente una copia in una cartella semplice può aiutare a distinguere una regola specifica del percorso da un problema di connessione generale, ma non utilizzare un secondo servizio di sincronizzazione cloud sulla stessa directory di sincronizzazione live.

Distinguere un problema del client da un problema di connessione del server.

Accedi allo stesso account Nextcloud tramite un browser e verifica che file e cartelle vengano caricati correttamente. Se l'interfaccia web funziona ma tutti i dispositivi desktop si bloccano, il problema potrebbe risiedere nell'endpoint WebDAV del server o nella sua configurazione. Il client Nextcloud utilizza WebDAV per accedere ai file del server. Per un server installato in https://cloud.example.com, il suo endpoint DAV è in genere https://cloud.example.com/remote.php/dav; utilizza il percorso di installazione effettivo. Aprendo tale indirizzo in un browser, dovrebbe almeno essere richiesta l'autenticazione o dovrebbe essere visualizzata una risposta dall'endpoint. Errori di autenticazione, avvisi relativi al certificato o errori del server sono segnali che indicano la necessità di contattare l'amministratore o di esaminare i log del server, anziché riavviare il client locale.

Verifica se un altro programma di sincronizzazione, un'utilità di backup o una funzionalità per i file offline gestisce la stessa directory. Il manuale di risoluzione dei problemi di Nextcloud indica che la sincronizzazione di una directory con più applicazioni di sincronizzazione non è supportata e può comportare il rischio di perdita di dati. Rimuovi la sovrapposizione solo dopo aver identificato quale applicazione è proprietaria della cartella e aver preservato le modifiche locali. Se il problema riguarda un solo computer, verifica lo spazio su disco locale, le autorizzazioni delle cartelle, l'antivirus o la scansione in tempo reale e se il client può leggere e rinominare i file nella directory di sincronizzazione.

Riavvia il sistema, quindi raccogli dati diagnostici utili.

1. Attendi il completamento di tutte le operazioni sui file attive, quindi chiudi il client desktop dalla barra delle applicazioni o dal menu. Riavvialo e verifica se il numero di operazioni in sospeso cambia.
2. Se il client continua a bloccarsi, apri le impostazioni e seleziona Avanzate → Crea archivio di debug… per salvare un archivio diagnostico. La posizione precisa di questo controllo può variare a seconda della versione e della piattaforma.
3. Esamina il registro nel periodo in cui lo stato ha smesso di aggiornarsi. Cerca il percorso interessato e un errore ripetuto, come accesso negato, errore di connessione o restrizione del nome file.

Gli archivi di debug includono log e informazioni sul database e possono contenere nomi di file sensibili, dettagli dell'account o indirizzi del server. Esaminali e oscurali prima di condividerli con l'assistenza. La documentazione di Nextcloud sulla risoluzione dei problemi descrive l'archivio di debug e altri metodi per acquisire i log del client.

Utilizzare il ripristino del database solo per l'errore corrispondente

Non eliminare sistematicamente il database di sincronizzazione del client per risolvere un generico stato "Elaborazione file". Nextcloud documenta una soluzione più specifica per l'errore "CSync unknown error" : arrestare il client, individuare il .sync_xxxxxxx.dbfile nascosto all'interno della cartella dell'account configurata dal client ed eliminare tale database prima di riavviarlo. La documentazione avverte che questa operazione cancella anche alcune impostazioni relative ai file da scaricare. Eseguire prima un backup della cartella di sincronizzazione locale e annotare le impostazioni di sincronizzazione selettiva; non eliminare mai un database mentre il client è in esecuzione. Se l'errore specifico non è presente, esaminare l'archivio di debug o contattare l'assistenza prima di tentare questa procedura di ripristino.

Conferma che la sincronizzazione è stata ripristinata

Dopo la modifica, verificate non solo la scomparsa dell'indicatore di caricamento. La coda delle richieste in sospeso dovrebbe svuotarsi, il client dovrebbe mostrare uno stato aggiornato e connesso e un piccolo file di prova dovrebbe apparire nella posizione prevista sia localmente che nell'interfaccia web. Confermate che il file originariamente interessato contenga il contenuto previsto e che le cartelle di sincronizzazione selettiva siano rimaste configurate correttamente. Se lo stesso file continua a presentare problemi, conservate l'errore esatto e un archivio di debug con le informazioni oscurate; un problema ricorrente relativo a permessi, nome file, WebDAV o versione del client richiede una soluzione mirata.

Per i controlli client e le procedure di risoluzione dei problemi più recenti, consultare il manuale utente di Nextcloud Desktop Client e la documentazione per la risoluzione dei problemi di Nextcloud Desktop . Il manuale utente online attualmente disponibile si riferisce a Nextcloud 36; le etichette dei client e le funzionalità di Virtual Files disponibili possono variare a seconda della versione del client desktop e del sistema operativo.