ඔබේ පරිගණකයේ සාර්ථකව ධාවනය වන Next.js යෙදුම Vercel වෙත Deploy කළ පසු ප sudden හිස් (white) තිරයක් පෙන්වනවා නම්, එය බොහොමයක් ඩෙවලොපර්ලා මුහුණ දෙන ගැටලුවකි. "හිස් තිරය" යන්න තනි හේතුවක් නොව, ගැටලුවේ ලක්ෂණයක් පමණයි. මේ ලිපියෙන් එම ගැටලුව නිවැරදිව හඳුනා ගැනීමට අවශ්ය පියවර 5ක් ඔබට හඳුන්වා දෙමු.
1. බ්රවුසර කන්සෝලය පරීක්ෂා කරන්න
පළමුව, බ්රවුසරයේ Console විවෘත කර බලන්න. JavaScript දෝෂයක් ඇතිනම්, එය කන්සෝලයේ පෙන්වයි. මෙය client‑side කේතයේ ගැටලුවක් බවට පෙන්වයි; කන්සෝලය නිශ්ශබ්ද නම්, ගැටලුව server‑side හෝ Deploy සැකසීමේදී සිදුවේ.
2. පරිසර වෙනස්කම් (Environment Variables) අතුරුදන් වී තිබේද?
ඔබේ .env.local ගොනුව ඔබේ මැෂීනයේ පමණක් ඇත, Vercel වෙත එය යවන එකක් නැත. Deploy කිරීමේදී process.env.SOMETHING වැනි වෙනස්කම් Vercel හි Environment Variables සැකසීම් වලට එක් නොකළහොත්, ඒවා undefined වේ. ඒ නිසා SDK එකක් හෝ API client එකක් දෝෂයකින් තොරව අසාර්ථකව වැඩ කරයි.
3. Build සාර්ථකව සිදු වී ඇත්ද?
Vercel කාලීනව build එක සම්පූර්ණ කර තිබුණත්, build‑time data fetching (generateStaticParams, server component fetch) අසාර්ථකව පවතිනවා නම්, HTML හි අන්තර්ගතය හිස් හෝ වැරදි විය හැක. Live URL එකේ View source කර HTML අන්තර්ගතය පරීක්ෂා කරන්න.
4. Output configuration හෝ directory ගැටළුවක්ද?
AI tool එකක් හෝ මාරු කිරීමකින් framework preset වෙනස් වූ පසු, Vercel වැරදි output directory එකක් හෝ build command එකක් භාවිතා කරයි. එවිට build ලොග් සාර්ථකයි කියලා පෙනේ, නමුත් output හි කිසිවක් නැති නිසා පිටුව හිස් වේ.
5. Node version අසමත්තාව
ඔබගේ කේතය නව Node.js හෝ JavaScript විශේෂාංග භාවිතා කරයි, එය Vercel හි build environment එකේ Node version එකට අනුකූල නොවෙයි. එවිට dependency level දෝෂයක් ඇතිව, පැහැදිලි error message එකක් නොලැබෙයි. Node version එක project settings තුළ පින් කර, local testing එකේ version එකට ගැළපෙනවාදැයි තහවුරු කරන්න.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ ඩෙවලොපර්, විද්යාර්ථීන්, ව්යාපාරිකයින්ට මේ ගැටළු හඳුනා ගැනීම ඉතා වැදගත්. Vercel වැනි cloud platform භාවිතා කර AI‑generated code deploy කරන වෙලාවේ, ඉහත පියවර 5ක් අනුගමනය කිරීමෙන් අයදුම්පත් production වල අසාර්ථකව යාම වැලැක්විය හැක. එමෙන්ම, environment variables නිවැරදිව සැකසීම, Node version lock කිරීම, build logs පූර්ණයෙන්ම විශ්ලේෂණය කිරීම යන අංගයන් දේශීය startup ගොඩනැගීමේ වේගය වැඩි කරයි. මෙයින් තාක්ෂණික කුසලතා වැඩිවීම, ගැටළු විසඳීමේ කාලය කෙටි වීම, සහ අන්තර්ජාතික cloud සේවා භාවිතයේ විශ්වාසය වර්ධනය වේ.
අවසන් වශයෙන්, හිස් තිරයක් පෙන්වීමේ පසුබැසි හේතු පරීක්ෂා කිරීමේ ක්රමය ඔබේ වැඩ පිළිවෙළේ අත්යවශ්ය කොටසක් බව මතක තබා ගන්න. මෙය ඔබේ යෙදුම නිසි ලෙස deploy වීමට සහ පරිශීලකයන්ට සුහද අත්දැකීමක් ලබා දීමට මග පෙන්වයි.
