Zinnector® CLI తో వ్యక్తులు నిజంగా ఎదుర్కొనే ఎర్రర్లు, వాటిలో ప్రతి ఒక్కదాని అర్థం, మరియు పరిష్కారం. ప్రతి ఎంట్రీ మీరు చూసే ఖచ్చితమైన టెక్స్ట్ను పేర్కొంటుంది, కాబట్టి మీరు దాని కోసం ఈ పేజీలో శోధించవచ్చు. మీది ఇక్కడ లేకపోతే, విఫలమవుతున్న కమాండ్ను ZINNECTOR_DEBUG=1 తో రన్ చేయండి మరియు అవుట్పుట్, మీ node --version మరియు మీ ఆపరేటింగ్ సిస్టమ్తో github.com/Zinn-Digital/zinnector/issues వద్ద ఒక సమస్యను ఓపెన్ చేయండి.
రన్టైమ్ ఇన్స్టాల్ను ఆమోదించిన వెంటనే "spawn EINVAL" (Windows)
Zinnector® 0.1.0 మరియు 0.1.1 లో ఒక బగ్. Windows లో రన్టైమ్ ఇన్స్టాలర్ npm.cmd ని పేరుతో రన్ చేసింది, మరియు Node CVE-2024-27980 కోసం దాని పరిష్కారం తర్వాత షెల్ లేకుండా .cmd ఫైల్ను స్పాన్ చేయడానికి నిరాకరించింది — కాబట్టి మీరు Y అని సమాధానం ఇచ్చిన ఒక సెకను తర్వాత ఇన్స్టాల్ క్రాష్ అయింది. 0.1.2 లో పరిష్కరించబడింది: npm ఇప్పుడు node npm-cli.js గా రన్ చేయబడుతుంది, ఇది ప్రతి ప్లాట్ఫారమ్లోనూ ఒకే విధంగా ఉంటుంది మరియు ఎటువంటి షెల్ అవసరం లేదు. npm install -g zinnector@latest రన్ చేయండి, ఆపై మళ్లీ zinnector dev రన్ చేయండి.
ఇన్స్టాల్ సమయంలో "npm WARN EBADENGINE", లేదా "Zinnector® needs Node 24 or newer"
మీ Node 24 కంటే పాతది. ప్యాకేజీ engines: >=24.18.1 ని ప్రకటించడం వల్ల npm హెచ్చరికను ప్రింట్ చేస్తుంది; ఇన్స్టాల్ ఎలాగైనా పూర్తవుతుంది, కానీ తరువాత అయోమయంగా ఎక్కడో విఫలం కావడం కంటే zinnector ప్రారంభించడానికి నిరాకరిస్తుంది (ఎగ్జిట్ కోడ్ 78). nodejs.org నుండి ప్రస్తుత LTS ని ఇన్స్టాల్ చేయండి — Windows లో winget install OpenJS.NodeJS.LTS, macOS లో brew install node@24 — node --version v24 లేదా అంతకంటే ఎక్కువ ప్రింట్ చేస్తుందో లేదో నిర్ధారించుకోండి, మరియు Zinnector® ని మళ్లీ ఇన్స్టాల్ చేయండి.
"gyp ERR!", "Building from source with node-gyp", లేదా "You need to install Visual Studio"
WordPress రన్టైమ్లో ఒక నేటివ్ మాడ్యూల్ ఉంది, దీని ప్రీబిల్ట్ బైనరీలు Node 24 మరియు 25 కోసం మాత్రమే ఉన్నాయి. కొత్త Node లో (సెప్టెంబర్ 2026 నాటికి, 26 మరియు ఆపై) దీని ఇన్స్టాలర్ సోర్స్ నుండి కంపైల్ చేయడానికి తిరిగి వెళ్తుంది, ఇది ఒక సాధారణ Windows మెషీన్లో Visual Studio కోసం అభ్యర్థనతో ముగుస్తుంది. 0.1.2 లో పరిష్కరించబడింది: Zinnector® ఏదైనా డౌన్లోడ్ చేయడానికి ముందే దీనిని గుర్తిస్తుంది మరియు రన్టైమ్ కోసం మాత్రమే Node 24 ని పొందుతుంది — సుమారు 30 MB, nodejs.org చెక్సమ్లకు వ్యతిరేకంగా ధృవీకరించబడింది — కాబట్టి ఏదీ ఎప్పటికీ కంపైల్ చేయబడదు. అప్గ్రేడ్ చేసిన తర్వాత కూడా మీరు దీనిని చూస్తున్నట్లయితే, zinnector dev --reset-runtime రన్ చేయండి, తద్వారా మునుపటి సగం పూర్తయిన ఇన్స్టాల్ మొదట విస్మరించబడుతుంది.
npm క్లీన్ అప్ చేస్తున్నప్పుడు దాని నుండి "EPERM" హెచ్చరికలు (Windows)
దాదాపు ఎల్లప్పుడూ npm తొలగించడానికి ప్రయత్నిస్తున్నప్పుడు రన్టైమ్ యొక్క node_modules క్రింద ఉన్న ఫైల్ను యాంటీవైరస్ స్కానర్ లేదా సెర్చ్ ఇండెక్సర్ తెరిచి ఉంచడం దీనికి కారణం. తదుపరి zinnector dev లో క్లీన్ డైరెక్టరీ నుండి ఇన్స్టాల్ మళ్లీ ప్రయత్నించబడుతుంది; ఇది ఇలాగే కొనసాగితే, zinnector dev --reset-runtime మొదట మొత్తం రన్టైమ్ డైరెక్టరీని తీసివేసి, మళ్లీ ఇన్స్టాల్ చేస్తుంది.
"the local playground runtime could not be installed"
ఈ మెసేజ్ npm యొక్క స్వంత చివరి లైన్లను మరియు Zinnector® రన్ చేసిన ఖచ్చితమైన కమాండ్ను కలిగి ఉంటుంది, కాబట్టి మీరు దానిని స్వయంగా రన్ చేసి పూర్తి అవుట్పుట్ను చూడవచ్చు. సాధారణ కారణాలు నెట్వర్క్ లేదా ప్రాక్సీ సమస్య — రన్టైమ్ మీ స్వంత npm తో పొందబడుతుంది, కాబట్టి npm config set proxy … మరియు రిజిస్ట్రీ మిర్రర్ వర్తిస్తాయి — లేదా మునుపటి సగం పూర్తయిన ఇన్స్టాల్, దీనిని --reset-runtime క్లియర్ చేస్తుంది.
"the local playground exited before it was ready", లేదా అది ఎప్పటికీ సిద్ధం కాకపోవడం
రన్టైమ్ యొక్క స్వంత అవుట్పుట్ను చూడటానికి zinnector dev --verbose రన్ చేయండి. ఇప్పటికే ఉపయోగంలో ఉన్న పోర్ట్ సాధారణమైనది: zinnector dev --port 9401, లేదా zinnector.json లో port ని సెట్ చేయండి. ఇన్స్టాల్ చేయబడినప్పటికీ బూట్ కాని రన్టైమ్: zinnector dev --reset-runtime. మొదటి బూట్ స్వయంగా WordPress ని కూడా డౌన్లోడ్ చేస్తుంది, కాబట్టి నెమ్మదిగా ఉన్న కనెక్షన్లో దీనికి కొన్ని నిమిషాలు సమయం ఇవ్వండి; నిలిచిపోవడానికి బదులుగా టైమ్అవుట్ను నివేదించడానికి ముందు CLI ఐదు నిమిషాల వరకు వేచి ఉంటుంది.
పుష్ చేసినప్పుడు "this project is not a git repository"
డిప్లాయ్లు రిపోజిటరీ నుండి నడపబడతాయి, కాబట్టి ప్లాట్ఫారమ్ చేరుకోగల రిమోట్తో కూడిన రిపోజిటరీ zinnector push కి అవసరం. git init && git add -A && git commit -m initial, మీ GitHub లేదా GitLab రిమోట్ను జోడించండి, ఆపై దానిని సైట్కు కనెక్ట్ చేయడానికి zinnector link చేయండి.
డిప్లాయ్ తర్వాత సైట్ తెల్లగా కనిపిస్తుంది
zinnector check రన్ చేయండి. పది సార్లలో తొమ్మిది సార్లు ఇది PHP వెర్షన్ తేడా — మీరు స్లాట్ రన్ చేసే దానికంటే కొత్త PHP లో బిల్డ్ చేసారు — మరియు రిపోర్ట్ స్లాట్ను ఏ వెర్షన్కు zinnector php <version> తో మార్చాలో, లేదా దేనికి వ్యతిరేకంగా zinnector dev --php <version> తో డెవలప్ చేయాలో చెబుతుంది. zinnector logs --error స్వయంగా ఫాటల్ ఎర్రర్ను చూపుతుంది.
సంబంధిత సమాచారం