المنفذ الافتراضي في Spring Boot: 5 طرق للتكوين

لماذا لا يريد تطبيق Spring Boot الخاص بك الاستماع على المنفذ 8080؟

تقوم بتشغيل أول تطبيق Spring Boot لك، وترى الشعار المرغوب في وحدة التحكم، وتفتح المتصفح - وتجد "Connection refused". موقف مألوف؟ غالبًا ما تكون المشكلة أن المنفذ 8080 مشغول بالفعل بعملية أخرى (مثل Skype أو Docker أو نسخة أخرى من تطبيقك نفسه). أو على العكس، تحتاج إلى تشغيل ثلاث خدمات مصغرة على جهاز واحد، وجميعها تريد الاستيلاء على نفس المنفذ.

في هذه المقالة، سنستعرض جميع الطرق الرئيسية لتكوين المنفذ في Spring Boot - من الأبسط إلى طرق "الإنتاج" الفعلية. ستتعلم كيفية تجاوز المنفذ من خلال ملفات التكوين، ومتغيرات البيئة، ووسائط سطر الأوامر، وحتى برمجيًا. وفي النهاية، سأقدم لك قائمة مرجعية لاختيار الطريقة المناسبة حسب الموقف.

الطريقة 1: application.properties - الطريقة الكلاسيكية

الطريقة الأكثر شيوعًا وبديهية. في الملف src/main/resources/application.properties، يكفي إضافة سطر واحد:

server.port=9090

هذا كل شيء. بعد إعادة التشغيل، سوف يستمع التطبيق على المنفذ 9090. إذا كنت بحاجة إلى العودة إلى 8080، فما عليك سوى حذف السطر أو تعليقه.

المزايا: البساطة، الوضوح، يعمل "مباشرة من الصندوق".

العيوب: مثبت بشكل ثابت في الكود - لكل بيئة (dev، test، prod) ستحتاج إلى تغيير الملف يدويًا أو استخدام الملفات الشخصية (profiles).

الطريقة 2: application.yml (YAML) - لعشاق التنظيم

إذا كنت تفضل تنسيق YAML، فسيكون التكوين على النحو التالي:

server:\n  port: 9090

لاحظ المسافات البادئة: مسافتان قبل port. YAML حساس للمسافات، لكنه يسمح بتجميع الإعدادات. على سبيل المثال، يمكنك تعيين كل من المنفذ ومسار السياق معًا:

server:\n  port: 9090\n  servlet:\n    context-path: /myapp

متى تستخدم: إذا كان مشروعك يستخدم بالفعل YAML لجميع التكوينات (على سبيل المثال، لـ Spring Cloud Config).

الطريقة 3: وسائط سطر الأوامر - المرونة لـ DevOps

الطريقة الأكثر مرونة، والتي تُستخدم غالبًا في الحاويات و CI/CD. عند تشغيل ملف JAR، ما عليك سوى تمرير المعامل:

java -jar myapp.jar --server.port=9090

أو، إذا كنت تستخدم إضافة Maven/Gradle:

mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=9090

وسائط سطر الأوامر لها أعلى أولوية بين جميع طرق التكوين في Spring Boot. هذا يعني أنها ستتجاوز حتى ما هو مكتوب في application.properties.

مثالي لـ: حاويات Docker، Kubernetes، عمليات النشر الآلي.

الطريقة 4: متغيرات البيئة - معيار تطبيقات العوامل الاثني عشر

يقرأ Spring Boot متغيرات البيئة تلقائيًا ويحولها إلى خصائص. القاعدة بسيطة: SERVER_PORT (بأحرف كبيرة، شرطة سفلية بدلاً من النقطة) ستصبح server.port.

في Linux/macOS:

export SERVER_PORT=9090\njava -jar myapp.jar

في Windows (cmd):

set SERVER_PORT=9090\njava -jar myapp.jar

في Docker Compose، يبدو هذا أكثر أناقة:

services:\n  myapp:\n    image: myapp:latest\n    ports:\n      - "9090:9090"\n    environment:\n      - SERVER_PORT=9090

لماذا هذا رائع: متغيرات البيئة لا تدخل إلى المستودع، ويسهل تغييرها لبيئات مختلفة، وتتبع منهجية تطبيق العوامل الاثني عشر (12-factor app).

الطريقة 5: التكوين البرمجي - للإدارة الدقيقة

أحيانًا تحتاج إلى حساب المنفذ ديناميكيًا (على سبيل المثال، العثور على منفذ متاح أو الحصول عليه من خدمة خارجية). هنا يأتي دور كود Java.

أبسط خيار هو تجاوز طريقة setServerPort في الكلاس