La funció funciona en posada en escena o quan l’optimització està desactivada, però la producció informa d’un error dins d’un paquet minificat d’una línia. El codi original pot dependre de l’ordre d’execució, contenir la sintaxi que l’optimitzador gestiona malament o combinar-se amb una dependència obsoleta.
Restaureu primer el recorregut crític de l’usuari i, a continuació, reproduïu la transformació fallida més petita.
Captura el fracàs públic amb precisió
Proveu com a visitant tancat i registreu la pàgina, l’acció, el navegador, el text d’error, l’URL de l’script i la línia/columna. Deseu el seguiment de la pila i l’estat de resposta de la xarxa.
Comproveu si l’error es produeix a la primera càrrega, després de navegar entre pàgines o només després d’obrir un component. Un visitant a la memòria cau pot rebre un paquet diferent d’una sessió nova.
Si els formularis o el pagament estan trencats, utilitzeu el bypass compatible amb l’optimitzador o desactiveu la transformació de JavaScript específica mentre feu el diagnòstic. Manteniu documentada la configuració anterior.
Confirmeu quina etapa d’optimització ho provoca
En la posada en escena, proveu aquests estats per separat:
- arxius individuals originals;
- minificat però no combinat;
- combinat sense minificació;
- retardat o ajornat després de la minificació;
- la configuració de producció completa.
El primer estat on apareix l’error redueix la causa. No canvieu, combini i retardeu junts i anomeneu el grup "l’optimitzador".
Manteniu el tema, les versions dels connectors i el contingut de la pàgina alineats amb la producció perquè la comparació sigui significativa.
Torna a assignar el paquet als fitxers font
Utilitzeu el manifest de l’optimitzador, el comentari d’origen o el mode de depuració per llistar fitxers dins del paquet. Cerqueu fonts originals per a la funció que falla o una cadena propera.
Si es produeix un mapa d’origen legítim, les eines de desenvolupament del navegador poden mapar la pila a la línia original. No exposeu els mapes de fonts privades públicament només per facilitar el diagnòstic; configurar l’accés segons la política de seguretat del projecte.
Compareu el contingut de la resposta amb el manifest actual. Un CDN pot publicar un paquet antic amb un URL reutilitzat.
Busqueu dependències de l’ordre d’execució
La combinació de fitxers pot canviar l’ordre quan les dependències només s’expressaven mitjançant etiquetes d’script separades. Un connector podria esperar que jQuery o un objecte de configuració global existeixi primer.
Els scripts de WordPress haurien de registrar les dependències de manera explícita. El codi personalitzat pot utilitzar:
wp_enqueue_script(
'site-checkout',
get_stylesheet_directory_uri() . '/js/checkout.js',
array('jquery', 'wc-checkout'),
'1.4.0',
true
);Utilitzeu mànecs verificats reals. No copieu aquest exemple de pagament en un lloc que registri diferents dependències.
Les dades "abans" i "després" en línia han de romandre al costat de la maneta correcta. Moure’l a un agregat pot invertir la seqüència requerida.
Comproveu la sintaxi i les transformacions no segures
Els minificadors més antics poden fallar amb la sintaxi de JavaScript més recent, les expressions regulars o el codi que depèn dels noms de les funcions/classes. És possible que els scripts de tercers ja estiguin minificats i no s’han de processar de nou.
Exclou el fitxer provat més petit de la minificació tot conservant el seu ordre de càrrega normal. Si sou el propietari de la font, actualitzeu l’eina de compilació o corregiu el codi no segur en lloc de mantenir una exclusió àmplia permanent.
No editeu mai a mà el paquet d’una línia generat; es regenerarà i no és la font de la veritat.
Elimineu les combinacions de memòria cau obsoletes
URL del paquet de versions quan canvia el seu contingut. Netegeu l’HTML afectat i l’URL exacte del recurs mitjançant els controls compatibles i, a continuació, proveu una sessió nova.
Un nou document HTML que fa referència a un paquet antic suprimit produeix un 404; HTML antic que fa referència a un paquet recentment sobreescrit pot crear codi incompatible. El desplegament atòmic o els noms de fitxer amb hash de contingut eviten aquest desajust.
No buideu cada memòria cau de producció repetidament. Augmenta la càrrega d’origen i fa que la fallada sigui més difícil de reproduir.
Executeu comprovacions de regressió
Després de la reparació estreta, proveu la navegació, els formularis, el consentiment, els controls lliscants i els fluxos de pagament autoritzats. Reviseu la consola en diverses plantilles i navegadors.
Confirmeu que l’recurs de producció es redueix o s’exclou exactament com es pretenia, es carrega una vegada i es manté estable durant una segona visita a la memòria cau. Enregistreu el fitxer responsable i el motiu de l’exclusió perquè una futura actualització del connector sol·liciti una revisió.
Sol·liciteu una avaluació quan el manifest del paquet no estigui disponible, les diferents capes de memòria cau proporcionen codi incoherent o hi hagi dependències de pagament/formulari. Compartiu primer l’evidència d’error públic i organitzeu l’accés segur només després d’acordar l’abast.