ปัญหาที่เจอบ่อย
หาหัวข้อที่ตรงกับอาการ แล้วทำตามทีละข้อ
คำสั่งทุกอันในหน้านี้ พิมพ์ในเทอร์มินัล ในโฟลเดอร์ร้าน (โฟลเดอร์ที่ตัวติดตั้งบอกไว้ตอนจบ) เข้าโฟลเดอร์ด้วย
cd ชื่อโฟลเดอร์
ตอนติดตั้ง
ดูตาราง ปัญหาที่เจอบ่อยตอนติดตั้ง
กฎข้อเดียวที่แก้ได้เกือบทุกอย่าง: พิมพ์ npx webneedee ซ้ำ
ของที่สร้างไปแล้วจะไม่ถูกสร้างซ้ำ และข้อมูลเดิมไม่หาย
เข้าหลังบ้านไม่ได้
เจอหน้า "ยังเปิดหลังบ้านไม่ได้" แทนช่องใส่รหัส
หน้านั้นจะบอกว่า "ระบบยังใช้ความลับตัวอย่างอยู่"
แปลว่า รหัสผ่านหรือกุญแจของร้านยังไม่ได้ตั้ง ระบบจึงปิดหลังบ้านไว้ให้เอง ถ้าไม่ปิด ใครก็เข้ามาเป็นเจ้าของร้านคุณได้
แก้ยังไง — วิธีง่ายที่สุดคือรันตัวติดตั้งซ้ำ ระบบตั้งให้เอง
npx webneedee
หรือตั้งเองทีละตัวตามที่หน้านั้นบอก
npx wrangler secret put ADMIN_PASSWORD
ตั้งเสร็จแล้วรอสักครู่ แล้วโหลดหน้าเดิมใหม่ — ไม่ต้อง deploy ซ้ำ
ลืมรหัสผ่านหลังบ้าน
ไม่มีปุ่ม "ลืมรหัสผ่าน" เพราะร้านไม่มีระบบอีเมล — ตั้งรหัสใหม่แทน
npx wrangler secret put ADMIN_PASSWORD
พิมพ์รหัสใหม่แล้วกด Enter (ตัวอักษรไม่ขึ้นบนจอ นี่ปกติ) มีผลทันที
ใส่รหัสถูกแล้วแต่ขึ้นว่า "รหัสผ่านไม่ถูกต้อง"
- ดูว่าเปิด Caps Lock ค้างไหม
- ดูว่าคีย์บอร์ดเป็นภาษาไทยอยู่ไหม
- ถ้าเพิ่งตั้งรหัสใหม่ รอสักครู่แล้วลองอีกครั้ง
- ยังไม่ได้ ก็ตั้งรหัสใหม่ตามหัวข้อบน
จู่ ๆ หลุดออกจากระบบ ทั้งคุณและสมาชิกทุกคนพร้อมกัน
แปลว่า กุญแจเซ็นคุกกี้ (SESSION_SECRET) ถูกเปลี่ยน
ไม่มีอะไรเสียหาย แค่ทุกคนต้องเข้าสู่ระบบใหม่ อย่าเปลี่ยนค่านี้อีกโดยไม่จำเป็น
ลูกค้าบอกว่าสั่งซื้อไม่ได้
ไล่ตามลำดับนี้
- เปิด ตั้งค่า › ตรวจสุขภาพร้าน — มีสีแดงข้อไหนไหม
- มีช่องทางรับเงินเปิดอยู่ไหม — ถ้าไม่มี ลูกค้าจะเห็นหน้าชำระเงินว่าง ๆ แล้วไปต่อไม่ได้ แก้ที่ ตั้งค่า › ขนส่ง & ชำระเงิน
- มีวิธีจัดส่งเปิดอยู่ไหม — ถ้าไม่มี ลูกค้าเลือกขนส่งไม่ได้ · แก้ที่หน้าเดียวกัน
- สินค้าที่เขาจะซื้อยังเปิดขายอยู่ไหม และสต๊อกเหลือไหม
- ถ้าเป็นสินค้าที่มีตัวเลือก ตัวเลือกที่เขาจะเลือกยังเปิดอยู่และมีสต๊อกไหม — ตัวเลือกที่ปิดหมดทุกชุด เท่ากับสินค้าหมด
- ลอง สั่งซื้อด้วยตัวเองหนึ่งรอบ ในโหมดไม่ระบุตัวตนของเบราว์เซอร์ ถ้าคุณสั่งได้ ปัญหาน่าจะอยู่ที่เครื่องของลูกค้า ให้เขาลองปิด-เปิดเบราว์เซอร์ใหม่
ลูกค้าไม่ได้รับรหัส OTP
| เช็ก | ทำยังไง |
|---|---|
| ยังอยู่ในโหมดทดลองไหม | ถ้ายัง รหัสจะขึ้นบนหน้าจอแทนที่จะส่ง SMS — วิธีปิด |
| ตั้งค่าผู้ให้บริการ SMS ครบไหม | SMS_PROVIDER, SMS_SENDER และกุญแจที่ตั้งด้วย wrangler secret put |
deploy หลังแก้ wrangler.jsonc แล้วหรือยัง |
ต้องสั่ง npm run deploy ทุกครั้งหลังแก้ไฟล์นี้ |
| เครดิต SMS ในบัญชีผู้ให้บริการหมดไหม | เข้าไปดูในหน้าของผู้ให้บริการ |
| ลูกค้าขอรหัสรัว ๆ ไหม | ระบบหน่วง 60 วินาทีต่อเบอร์ · และกรอกผิดได้ 5 ครั้ง |
ถ้าปิดโหมดทดลองแล้วแต่ยังตั้งค่า SMS ไม่ครบ ระบบจะปฏิเสธการขอ OTP ทั้งหมด เป็นความตั้งใจ — ไม่ปล่อยให้ระบบยืนยันตัวตนทำงานครึ่ง ๆ กลาง ๆ
สต๊อกไม่ตรง
ระบบตัดสต๊อกตั้งแต่ตอนลูกค้ากดสั่ง ไม่ใช่ตอนจ่ายเงิน เพื่อไม่ให้ขายของชิ้นเดียวกันซ้ำสองคน
ดังนั้น ออเดอร์ที่ลูกค้าทิ้งไว้ไม่จ่าย ยังกินสต๊อกอยู่
แก้ยังไง: เปิด คำสั่งซื้อ → ติ๊กตัวกรอง "รอโอนเกิน 24 ชม." → ทักลูกค้า ถ้าเงียบ กดยกเลิก สต๊อกจะคืนกลับมาเองอัตโนมัติ
ข้อจำกัดที่รู้อยู่: ถ้าสองคนกดซื้อของชิ้นสุดท้ายพร้อมกันในจังหวะเดียวกันเป๊ะ ระบบให้ผ่านทั้งคู่ ทำให้ขายเกินได้ 1 ชิ้น เกิดยาก แต่เกิดได้ — ถ้าเจอ ให้ติดต่อลูกค้าคนหลังแล้วคืนเงินหรือส่งรอบหน้า
รูปที่อัปโหลดไม่ขึ้น
- ดูขนาดไฟล์ — รูปจากกล้องมือถือรุ่นใหม่บางรุ่นใหญ่มาก ลองย่อก่อน
- ดูชนิดไฟล์ — ใช้
.jpg,.pngหรือ.webp - ลองรีเฟรชหน้าแล้วอัปใหม่
- ถ้าอัปไม่ได้ทุกไฟล์ ให้ดูว่าที่เก็บรูป (R2) ในบัญชี Cloudflare ยังใช้งานได้อยู่ไหม — เช่น บัตรที่ผูกไว้หมดอายุ
วิดีโอที่ฝังไว้ไม่ขึ้น
สาเหตุอันดับหนึ่ง: ใช้ลิงก์ย่อ
ลิงก์แบบ vm.tiktok.com/xxxx ที่ได้จากปุ่มแชร์ในแอป ใช้ไม่ได้
ต้องใช้ลิงก์เต็มที่มีชื่อบัญชีและเลขวิดีโอครบ เช่น
https://www.tiktok.com/@ชื่อบัญชี/video/1234567890123456789
วิธีเอาลิงก์เต็ม: เปิดวิดีโอในเบราว์เซอร์ (ไม่ใช่ในแอป) แล้วก็อปจากแถบที่อยู่
รองรับเฉพาะ YouTube · TikTok · Instagram Reel เท่านั้น ลิงก์จากที่อื่นจะไม่กลายเป็นวิดีโอ
เปิดไฟล์ CSV แล้วภาษาไทยเพี้ยน
ไฟล์ที่ระบบสร้างเปิดใน Excel ได้ทันที ทั้งภาษาไทยและเลข 0 หน้าเบอร์โทร
ถ้ายังเพี้ยน มักเป็นเพราะเปิดด้วยโปรแกรมอื่นที่ตั้งค่าไว้ต่างออกไป ลองเปิดด้วย Excel โดยตรง หรือใน Google Sheets ให้ใช้ File → Import แล้วเลือกไฟล์
เว็บช้า
- รูปใหญ่เกินไป — สาเหตุอันดับหนึ่ง ย่อรูปก่อนอัปโหลด รูปสินค้าไม่ต้องใหญ่เกิน 1600 พิกเซลด้านยาว
- ฝังวิดีโอ TikTok หรือ Instagram หลายอันในหน้าเดียว — แต่ละอันโหลดตัวเล่นของแพลตฟอร์มนั้น
- ถ้าช้าเฉพาะครั้งแรกหลัง deploy ถือว่าปกติ
รันในเครื่องแล้วขึ้น error no such table: settings
แปลว่ายังไม่ได้เตรียมฐานข้อมูลในเครื่อง สั่งครั้งเดียว
npm run setup
แล้วค่อย
npm run dev
ฐานข้อมูลในเครื่องกับฐานข้อมูลของร้านจริงเป็นคนละชุดกัน แก้ในเครื่องไม่กระทบร้านจริง และข้อมูลจริงไม่ถูกดึงลงมา
อยากเปลี่ยนชื่อร้าน
| เปลี่ยนอะไร | ทำยังไง |
|---|---|
| ชื่อร้านที่ลูกค้าเห็น | หลังบ้าน → ตั้งค่า › ตั้งค่าร้าน → ช่องชื่อร้าน — เปลี่ยนได้ตลอด |
ที่อยู่เว็บ (ชื่อร้าน.xxx.workers.dev) |
เปลี่ยนไม่ได้จากหลังบ้าน · ถ้าอยากได้ชื่อใหม่ ให้ผูกโดเมนของตัวเองแทน |
การผูกโดเมนของตัวเองอยู่ที่ เปิดร้านให้พร้อมขาย › อยากใช้ชื่อเว็บของตัวเอง
สำรองข้อมูล
ทำเองได้ทันทีจากหลังบ้าน — โหลด CSV เก็บไว้เป็นประจำ
| โหลดจาก | ได้อะไร |
|---|---|
| คำสั่งซื้อ → CSV รายออเดอร์ + CSV รายสินค้า | ประวัติการขาย |
| สินค้า → CSV รายสินค้า + CSV รายตัวเลือก | รายการสินค้าและสต๊อก |
| สมาชิก → ส่งออก CSV | รายชื่อสมาชิก |
แนะนำให้โหลดเก็บ เดือนละครั้ง ใส่โฟลเดอร์ที่สำรองอยู่แล้ว
⚠️ ไฟล์เหล่านี้มีชื่อ ที่อยู่ และเบอร์ของลูกค้า — เก็บให้มิดชิด ไม่วางบนที่สาธารณะ
ฐานข้อมูลตัวจริงอยู่บนบัญชี Cloudflare ของคุณ และ Cloudflare มีเครื่องมือกู้คืนของเขาเอง ดูที่หน้า D1 ในแผงควบคุม Cloudflare
อัปเดตเป็นเวอร์ชันใหม่
เมื่อผู้ขายปล่อยเวอร์ชันใหม่ จะมีวิธีอัปเดตแจ้งมาพร้อมกัน ก่อนอัปเดตทุกครั้ง โหลด CSV เก็บไว้ก่อน ตามหัวข้อบน
ลงทะเบียนลิขสิทธิ์ไว้ (เมนู ตั้งค่า › ลิขสิทธิ์) เพื่อให้ผู้ขายรู้ว่าจะส่งเวอร์ชันใหม่ไปหาที่ไหน
ขอความช่วยเหลือ
ก่อนติดต่อ เตรียมข้อมูลพวกนี้ไว้ จะได้จบในรอบเดียว
- ที่อยู่เว็บร้านของคุณ
- ทำอะไรอยู่ตอนที่เจอปัญหา — หน้าไหน กดปุ่มอะไร
- ข้อความผิดพลาดที่เห็น — ถ่ายภาพหน้าจอมาเลย
- ถ้าเป็นปัญหาตอนติดตั้ง ก็อปข้อความในเทอร์มินัลมาทั้งหมด
- ผลจากหน้า ตั้งค่า › ตรวจสุขภาพร้าน — ถ่ายภาพหน้าจอ
⚠️ อย่าส่งรหัสผ่านหลังบ้าน กุญแจผู้ช่วย AI หรือกุญแจ SMS ให้ใครทั้งสิ้น ไม่มีใครต้องใช้มันเพื่อช่วยคุณ