Troubleshooting

Guide Complete per Evitare Problemi WordPress

2 min di lettura

Il messaggio “Brevemente non disponibile per manutenzione programmata” che non scompare è uno dei problemi più frustranti. Ecco perché succede e come risolverlo in meno di 5 minuti.

Perché WordPress Rimane Bloccato

Durante un aggiornamento, WordPress crea un file .maintenance nella root del sito. Se l’aggiornamento fallisce (timeout, errore PHP, memoria esaurita), questo file rimane e blocca l’accesso.

Soluzione Rapida: Eliminare .maintenance

# Via SSH/FTP, elimina il file nella root
rm .maintenance

# Via WP-CLI
wp eval "unlink(ABSPATH.'.maintenance');"

# Verifica che non esista più
ls -la .maintenance

Importante: Il file .maintenance è nascosto (inizia con punto). Assicurati che il tuo client FTP mostri i file nascosti.

Il Problema Vero: Aggiornamento Incompleto

Eliminare .maintenance sblocca il sito, ma se l’aggiornamento non è completato potresti avere problemi. Verifica:

# Controlla plugin con aggiornamenti disponibili
wp plugin list --update=available

# Controlla temi
wp theme list --update=available

# Controlla core
wp core check-update

Completare Aggiornamenti Falliti

# Aggiorna plugin specifico
wp plugin update problematic-plugin --force

# Aggiorna tutti i plugin
wp plugin update --all

# Aggiorna core WordPress
wp core update

# Se un plugin è corrotto, reinstalla
wp plugin install plugin-name --force

Prevenire Aggiornamenti Falliti

1. Aumenta i Limiti PHP

// In wp-config.php
define( 'wp_MEMORY_LIMIT', '256M' );

// In .htaccess o php.ini
php_value max_execution_time 300
php_value memory_limit 256M

2. Usa WP-CLI per Aggiornamenti

# Gli aggiornamenti via CLI sono più affidabili
wp plugin update --all
wp theme update --all
wp core update
wp core update-db

3. Disabilita Aggiornamenti Automatici Rischiosi

// In wp-config.php - aggiornamenti solo minor
define( 'wp_AUTO_UPDATE_CORE', 'minor' );

// Disabilita auto-update plugin
add_filter( 'auto_update_plugin', '__return_false' );

Checklist Post-Sblocco

□ rm .maintenance (sblocca il sito)
□ wp plugin list --update=available (verifica pending)
□ wp plugin update --all (completa aggiornamenti)
□ wp core verify-checksums (integrità file)
□ Testa frontend e backend
□ Controlla error log per problemi residui

Aggiornamenti critici da fare? Non rischiare downtime: contattaci per una gestione professionale degli update con staging environment.

Articoli correlati