AhmadNovilAkwan
/
TKK_E32231503
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
TKK_E32231503/backend/TROUBLESHOOTING_RAILWAY.md

5.5 KiB
Raw Blame History

🔧 Troubleshooting Railway Deployment

❌ Error 502: Application Failed to Respond

Penyebab Umum:

  1. Missing Dependencies
  2. Port Binding Error
  3. Database Connection Failed
  4. Syntax Error di Code
  5. Environment Variables Salah

🔍 Cara Debug

1. Cek Railway Logs

Di Railway Dashboard:

  1. Go to your project
  2. Click service name
  3. Click "Deployments"
  4. Click latest deployment
  5. View "Deploy Logs" dan "Application Logs"

Cari error:

Error: Cannot find module 'websocket-stream'
Error: listen EADDRINUSE: address already in use :::1883
Error: connect ECONNREFUSED
SyntaxError: Unexpected token

🛠️ Fix yang Sudah Dilakukan

Fix 1: Remove digitalRead() Error

Error:

relay1: digitalRead(RELAY1) === 'LOW',  // ❌ Arduino function in Node.js

Fix:

relay1: latestData.relay1 || false,  // ✅ Keep current status

Status: ✅ FIXED (commit b08ad68)

Fix 2: Disable MQTT Broker

Error:

Error: listen EADDRINUSE: address already in use :::1883

Penyebab: Railway tidak support custom ports (1883, 8883)

Fix:

if (process.env.ENABLE_MQTT_BROKER === 'true') {
  mqttServer.listen(MQTT_PORT, () => {
    console.log(`🚀 MQTT Broker running`);
  }).on('error', (err) => {
    console.warn(`⚠️  MQTT Broker failed`);
  });
} else {
  console.log('ℹ️  MQTT Broker disabled');
}

Status: ✅ FIXED (commit b08ad68)

Fix 3: Add Missing Dependency

Error:

Error: Cannot find module 'websocket-stream'

Penyebab: websocket-stream digunakan di code tapi tidak ada di package.json

Fix:

{
  "dependencies": {
    "websocket-stream": "^5.5.2"  // ✅ Added
  }
}

Status: ✅ FIXED (commit 794201c)

🧪 Test Deployment

Tunggu 2-3 Menit

Railway perlu waktu untuk:

  1. Pull code dari GitHub
  2. Install dependencies (npm install)
  3. Build (jika perlu)
  4. Start server (npm start)

Test Health Check

# PowerShell
Invoke-WebRequest -Uri "https://web-production-47eb.up.railway.app/" -UseBasicParsing

# Expected Response:
# StatusCode: 200
# Content: {"status":"OK","message":"Pengering Ikan Backend Server",...}

Test Database

Invoke-WebRequest -Uri "https://web-production-47eb.up.railway.app/api/database/test" -UseBasicParsing

# Expected Response:
# {"success":true,"message":"Database connection successful"}

📊 Expected Railway Logs

Successful Deployment:

Building...
✓ Dependencies installed
✓ Build completed

Starting...
📦 Using MYSQL_URL for connection
🔧 Database Config: { host: 'mysql.railway.internal', ... }
✅ Database connected successfully
✅ Database tables initialized
ℹ️  MQTT Broker disabled (use external MQTT broker like HiveMQ)
ℹ️  WebSocket MQTT disabled
🚀 REST API running on port 3000
✅ Server is ready!

Failed Deployment:

Building...
✓ Dependencies installed

Starting...
Error: Cannot find module 'xxx'
  at Function.Module._resolveFilename
  ...
Application exited with code 1

🔄 Jika Masih Error 502

1. Cek Railway Logs

Lihat error message di logs.

2. Cek Environment Variables

Pastikan ada:

MYSQL_URL=mysql://root:...@mysql.railway.internal:3306/railway
NODE_ENV=production
PORT=3000

3. Cek Dependencies

Pastikan semua dependencies ada di package.json:

{
  "dependencies": {
    "express": "^4.18.2",
    "cors": "^2.8.5",
    "aedes": "^0.51.3",
    "ws": "^8.16.0",
    "websocket-stream": "^5.5.2",  // ← Harus ada!
    "dotenv": "^16.4.5",
    "morgan": "^1.10.0",
    "mysql2": "^3.9.1"
  }
}

4. Test Locally

cd backend
npm install
npm start

# Jika error, fix dulu sebelum push

5. Restart Railway Service

Di Railway Dashboard:

  • Click service
  • Click "Settings"
  • Click "Restart"

📝 Checklist Deployment

  • Fix digitalRead() error
  • Disable MQTT broker
  • Add websocket-stream dependency
  • Wait for Railway deploy (2-3 menit)
  • Test health check endpoint
  • Test database connection
  • Initialize database tables
  • Test with ESP32

🎯 Next Steps

1. Tunggu Deploy Selesai

Railway sedang deploy dengan fix terbaru.

2. Test Endpoints

cd C:\Users\abilh\aplikasi_novil\backend
.\test-railway.ps1

3. Cek Logs

Jika masih error, cek Railway logs untuk error message.

4. Initialize Database

Invoke-WebRequest -Uri "https://web-production-47eb.up.railway.app/api/database/init" -Method POST -UseBasicParsing

🆘 Jika Masih Gagal

Option 1: Simplify Server

Buat versi minimal tanpa MQTT:

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.json({ status: 'OK' });
});

app.listen(3000, () => {
  console.log('Server running');
});

Test apakah ini bisa deploy. Jika bisa, tambahkan fitur satu per satu.

Option 2: Check Railway Status

Cek https://status.railway.app/ untuk service outage.

Option 3: Redeploy

Di Railway Dashboard:

  • Click "Deployments"
  • Click "Redeploy" pada deployment terakhir

📚 Resources

✅ Current Status

Latest Commit: 794201c - Add missing websocket-stream dependency
Deploy Status: ⏳ Deploying...
Expected Time: 2-3 minutes

Tunggu deploy selesai, lalu test! 🚀