Que l’error aparegui després d’una actualització és una pista temporal forta, però no demostra que el component sigui defectuós. Pot haver exposat una plantilla antiga, codi incompatible, JavaScript generat obsolet o un requisit PHP diferent.
Protegeix les comandes, conserva les versions i prepara una reparació reversible. Baixar diversos connectors a l’atzar dificulta demostrar-ne la causa.
Determina el risc transaccional
Revisa comandes, transaccions i registres des del primer error. Cerca pagaments sense comanda coincident i comandes en estats inesperats. Pausa les campanyes o el mètode afectat si existeix risc de cobrament duplicat.
Anota l’hora, la versió anterior i nova, qui ha actualitzat i canvis simultanis de PHP, caché o allotjament.
No restauris encara una base de dades antiga: podria eliminar comandes recents.
Captura l’error exacte
Reprodueix una vegada amb un producte controlat i un mètode segur. Registra errors de Console, l’estat de la petició i els logs PHP/WooCommerce de la mateixa hora.
Registre mínim:
- component i canvi de versió
- primera hora coneguda
- ruta de checkout afectada
- evidència HTTP, PHP o JavaScript
- ID de comandes o pagaments incertsExclou dades personals i de targeta.
Localitza la frontera de compatibilitat
Llegeix el changelog i els requisits del component. Compara les versions de WordPress, WooCommerce i PHP. Consulta l’estat de WooCommerce per detectar plantilles sobreescrites antigues.
Un tema pot copiar templates que ja no coincideixen amb els hooks o el marcatge. Un connector propi pot cridar funcions retirades o esperar paràmetres anteriors. Els bundles generats poden barrejar fitxers vells i nous.
No atribueixis l’error a qualsevol avís de plantilla: relaciona’l amb la ruta trencada.
Decideix entre rollback i reparació
Si la facturació està afectada i la versió anterior era estable, un rollback controlat pot contenir la incidència. Fes una còpia recent, verifica l’origen del paquet i reverteix només el component implicat.
No restauris tota la base de dades per desfer fitxers. Tampoc reverteixis una actualització de seguretat sense protecció compensatòria i un pla immediat per avançar.
Si el rollback no és segur o no resol l’error, repara la incompatibilitat a staging i publica el canvi mínim.
Prova en un staging equivalent
Iguala PHP, WooCommerce, tema, connectors i ajustos pertinents. Impedeix que staging enviï correus a clients, indexi pàgines o cobri en viu. Utilitza credencials de test i dades sanejades.
Canvia una variable cada vegada: versió, plantilla, extensió de checkout o optimització. Un tema estàndard localitza la capa, però substituir el disseny de producció rarament és la solució definitiva.
Registra cada resultat i la seva reversió.
Revisa el codi propi i les plantilles
Cerca al stack el primer fitxer controlat pel web. Actualitza hooks obsolets, signatures i gestió de valors nuls. Compara els templates sobreescrits amb els actuals i reintegra els canvis de disseny necessaris.
No editis el nucli de WooCommerce ni el tema pare. Se sobreescriuran a l’actualització següent i crearan una altra urgència.
Afegeix control de versions al codi corregit.
Neteja les memòries cau correctes
Després de modificar fitxers, neteja OPcache si cal, bundles CSS/JS, caché WordPress i edge per als assets del checkout. No eliminis sessions de clients si no has demostrat corrupció.
Confirma des d’un navegador anònim que arriba la versió esperada. Un servidor corregit amb JavaScript antic continua semblant trencat.
Versiona l’asset per evitar la caché mòbil persistent.
Executa proves transaccionals
Prova convidat i client, passarel·les actives, enviament, impostos, cupons, estoc, correus, webhooks, estats i mòbil. Confirma exactament una comanda i un pagament per intent.
Vigila els registres i callbacks després de reobrir. Concilia les transaccions incertes del període afectat abans de declarar el servei restaurat.
El manteniment recurrent ha de preparar actualitzacions a staging, conservar paquets de rollback i executar compres controlades després de canvis de tema, pagament, caché o camps.