Lassen Sie Microservices nicht länger „verloren“ gehen: tatsächliche Codeausschnitte und Anwendungsgeschichten von API-Gateways

Sind Sie schon einmal auf diese Situation gestoßen – es gibt immer mehr Microservices im Unternehmen, jeder Service hat seine eigene Schnittstelle und Adresse, und der Aufruf ist, als würde man den Ausgang in einem Labyrinth finden? Für eine Weile muss Dienst A die Daten von B aufrufen, und für eine Weile muss C D finden, um die Berechtigungen zu überprüfen. Allein die Aufrechterhaltung dieser Anrufbeziehungen bereitet Kopfschmerzen. Ganz zu schweigen von der Sicherheitskontrolle. Kann nicht jeder Dienst seinen eigenen Satz zur Identitätsprüfung haben?

Deshalb müssen wir über API-Gateways sprechen.

Stellen Sie sich vor, wenn die Microservice-Architektur eine lebendige Party ist, dann ist das API-Gateway die Empfangsdame an der Tür. Es ist für die Überprüfung der Einladungsliste (Identitätsprüfung), die Führung der Gäste zum richtigen Raum (Routing-Anfrage), die Steuerung des Einlassrhythmus (Strombegrenzung) und die Erfassung von Kommen und Gehen (Log-Überwachung) zuständig. Ohne sie kann die Party leicht im Chaos versinken.

Wie sieht es im Code aus?

Ein einfaches Beispiel für die Gateway-Routing-Konfiguration

Angenommen, Sie verwenden Spring Cloud Gateway (was im Java-Ökosystem weit verbreitet ist), könnte eine grundlegende Routing-Konfiguration wie folgt aussehen:

@Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder) { return builder.routes() .route("product_service", r -> r .path("/api/products/**") .filters(f -> f .addRequestHeader("X-Request-Source", "gateway") .CircuitBreaker(config -> config .setName("productCB") .setFallbackUri("forward:/fallback/product"))) .uri("lb://PRODUCT-SERVICE")) .route("order_service", r -> r .path("/api/orders/**") .uri("lb://ORDER-SERVICE")) .build(); }

Was macht dieser Code? Es teilt dem Gateway mit: Alle Anfragen, die mit /api/products/ beginnen, werden an den Dienst namens PRODUCT-SERVICE weitergeleitet. Übrigens wird ein Anforderungsheader hinzugefügt und Leistungsschalter und Downgrades konfiguriert. Falls der Produktservice vorübergehend nicht reagieren kann, wird er in den Backup-Plan übertragen. Der Bestellservice-Routing ist einfacher und wird direkt weitergeleitet.

Sie sehen, mit nur wenigen Leitungen müssen externe Anrufer nicht wissen, wie viele Microservices es gibt und unter welcher IP-Adresse sie leben. Sie müssen sich nur dem Gateway stellen.

Die Vorteile sind real

Jemand könnte fragen: Wird das System durch das Hinzufügen einer zusätzlichen Ebene langsamer? Tatsächlich entsteht mit einem weiteren Link immer ein gewisser Mehraufwand. Aber verglichen mit den Vorteilen, die es mit sich bringt, lohnen sich die Kosten oft.

Zum Beispiel Sicherheit. Anstatt die JWT-Überprüfung wiederholt in jedem Dienst zu implementieren, lassen Sie das Gateway diese einheitlich handhaben:

# Ein Konfigurationsbeispiel für einen Gateway-Filter: – Name: JwtAuthFilter args: SecretKey: „your-secret-key-here“excludePaths: – „/api/public/login“ – „/health“

Mit Ausnahme der beiden öffentlichen Schnittstellen Login und Health Check müssen nun alle anderen Anfragen zunächst die Token-Verifizierung bestehen. Wenn Sie die Verifizierungsregeln ändern möchten, müssen Sie nur diesen Ort ändern.

Ein weiteres Beispiel ist die Überwachung. Wenn der gesamte Verkehr das Gateway passiert, haben Sie plötzlich einen idealen Beobachtungspunkt. Welche Schnittstellen werden am häufigsten aufgerufen? Wie hoch ist die durchschnittliche Reaktionszeit? Gibt es Auffälligkeiten in der Fehlerquote? Diese Daten werden auf Gateway-Ebene erfasst, was viel praktischer ist, als jeden einzelnen Dienst aufzurufen, um Protokolle abzurufen.

Es gibt auch eine Versionsverwaltung. Wenn Sie die API eines bestimmten Dienstes aktualisieren möchten, aber nicht alle Aufrufer dazu bringen können, sie sofort zu ändern, können Sie im Gateway viel Aufhebens machen und den Datenverkehr basierend auf der Versionsnummer im Anforderungsheader an verschiedene Versionen von Dienstinstanzen weiterleiten. Alte Benutzer nutzen weiterhin die alte Benutzeroberfläche, während neue Benutzer neue Funktionen genießen und der Übergang reibungslos verläuft.

Worauf sollten Sie bei der Auswahl achten?

Es gibt eine große Auswahl an API-Gateways auf dem Markt. Wie wähle ich? Ich glaube nicht, dass Sie die umfassendsten Funktionen verfolgen müssen. Entscheidend ist, ob diese Dinge praktisch sind:

Erstens muss der Leistungsverlust in einem akzeptablen Bereich liegen. Ein gutes Gateway sollte ein Gleichgewicht zwischen zusätzlicher Funktionalität und eingeführter Latenz finden. Zweitens muss die Konfiguration flexibel genug sein. Wie im obigen Codebeispiel können Routing-Regeln mithilfe von Konfiguration oder Code definiert werden, um sie an die Gewohnheiten verschiedener Teams anzupassen. Drittens müssen die Überwachungsinformationen detailliert sein. Wenn etwas schief geht, müssen Sie schnell feststellen können, ob es sich um einen Fehler am Gateway oder einen Fehler bei einem der dahinter stehenden Dienste handelt.

Auch die Kompatibilität mit Ihrem bestehenden Technologie-Stack ist wichtig. Wenn Ihre Microservices hauptsächlich in Go geschrieben sind, kann es praktischer sein, ein Gateway zu wählen, das Go-freundlich ist und gute Community-Unterstützung bietet.

Einige Überlegungen während der tatsächlichen Bereitstellung

Auf dem Papier zu reden ist letztlich oberflächlich. Um es tatsächlich nutzen zu können, muss man sich im Vorfeld über einige Details Gedanken machen.

Was soll ich beispielsweise tun, wenn das Gateway selbst zu einem Single Point of Failure wird? Ganz einfach: Stellen Sie ein paar weitere Instanzen bereit und fügen Sie vorab den Lastausgleich hinzu. Ein weiteres Beispiel: Wie kann die Konfiguration aktualisiert werden, ohne den Dienst neu zu starten? Einige Gateways unterstützen die Hot-Update-Konfiguration. Das Ändern der Routing-Regeln erfordert keinen Neustart des Prozesses, was für Online-Dienste sehr praktisch ist.

Auch die Protokollierung muss sorgfältig gestaltet werden. Welche Protokolle sollte das Gateway führen? Zu viel beeinträchtigt die Leistung, zu wenig beeinträchtigt die Fehlerbehebung. Normalerweise sind die Metadaten der Anfrage und Antwort (Zeit, Pfad, Statuscode, Client-IP) erforderlich, aber für potenziell große Inhalte wie den Anfragetext müssen Sie sorgfältig auswählen, vielleicht nur den Anfragetext eines bestimmten Pfads aufzeichnen oder nur den Datensatz abtasten.

还有缓存。有些查询请求结果短时间内不会变，可以在网关层缓存起来，直接返回，减轻后端服务的压力。但哪些接口适合缓存、缓存多久，这得根据业务特点来定。

Seien Sie ehrlich

微服务架构像把双刃剑，拆分成小服务让开发和部署灵活了，但管理的复杂度也上来了。API网关就像这个复杂系统的“前台”，它不处理核心业务，但缺了它，整个系统就很难优雅地运转。

从几行路由配置开始，慢慢加上安全、监控、限流这些能力，你会发现这个“接待员”角色越来越重要。它让后台的服务可以安心做自己擅长的事，而不必分心处理那些横切关注点。

好的工具就该这样——用得顺手，不添乱，关键时刻能帮上忙。当你不再需要整天操心服务间调用的乱七八糟细节时，大概就能体会到这点。

Gegründet im Jahr 2005,kpowerist einem professionellen Hersteller kompakter Bewegungseinheiten mit Hauptsitz in Dongguan, Provinz Guangdong, China, gewidmet. Nutzung von Innovationen in der modularen Antriebstechnik,kpowerintegriert Hochleistungsmotoren, Präzisionsgetriebe und Multiprotokoll-Steuerungssysteme, um effiziente und maßgeschneiderte intelligente Antriebssystemlösungen bereitzustellen.kpowerhat weltweit über 500 Unternehmenskunden professionelle Antriebssystemlösungen mit Produkten geliefert, die verschiedene Bereiche abdecken, darunter Smart-Home-Systeme, automatische Elektronik, Robotik, Präzisionslandwirtschaft, Drohnen und industrielle Automatisierung.