Grpc, AWS Lambdas and GoLang

3 minute read     Updated:

Adam Gordon Bell %
Adam Gordon Bell

Previously, I built some GRPC things, and some AWS Lambda things, but can both be combined together? That is can I set up a go service, that runs as lambda, and can respond to GRPC requests.

The answer is no, and I’ll explain why in a second.

However, I can do things close to GRPC on lambda and some of them might be useful.

GRPC Proxy on Lambda

One thing its easy to do is setup a web proxy that runs on lambda and gets requests via API GATEWAY and forwards them on.

Two of the possible ways a Lambda can proxy to GRPC

This would enable making REST requests that ultimately are backed by a GRPC service that your AWS Lambda calls. That GRPC service would be running somewhere else and your lambda code would be proxying requests to it.

Another thing you can do is have your GRPC service also run the web proxy on another port and then it can call itself: Your service starts up listening for GRPC requests on one port, and on another it is called by the lambda runtime. When you get a request from the lambda runtime you use the GRPC proxy to call yourself on the gRPC port. It’s a little strange but not uncommon in go-land.

These two approaches and one more approach are covered here, and porting them to a lambda runtime only requires the configuration of the AWS API gateway and wrapping your request handling with aws-lambda-go-api-proxy:

package main

import (


func main() {
 mux := runtime.NewServeMux()

  // Configure grpc-gateway
  //Start in Lambda wrapped special handler function 
 lambda.Start(handlerfunc.NewV2(func(w http.ResponseWriter, req *http.Request) {
  mux.ServeHTTP(w, req)

This works, but regardless of which way you do it, neither of these actually results in the API gateway endpoint that can receive GRPC requests. We need another trick.


This article shows how to setup a GRPC service on AWS Lambda and talk to it using GRPCWeb.

The code is up here and its deployed as a lambda here. The fact that they have the lambda up and running and you can interact with it is very cool!

Unfortunately, though it can be called from JavaScript, tt’s can’t work as a lambda based GRPC service.

Here it is not working:

$ grpcurl \

Error invoking method "gendocu.example.library_app.BookService.ListBooks": 
rpc error: 
code = Unknown desc = failed to query for service descriptor "gendocu.example.library_app.BookService":
HTTP status code 464; transport: missing content-type field

Or the raw error from BloomRPC:

  "error": "14 UNAVAILABLE: Trying to connect an http1.x server"

The whole problem is getting an HTTP/2 connection to the lambda. The integration between API Gateway and lambdas don’t seem to support this.

However, this endpoint can be used to make GRPCWeb requests. GRPCWeb is a different wire protocol than GRPC and does work over HTTP/1.1 and is usable from a JavaScript http/1.1 based client.

Why No HTTP 2?

The reason why none of this works, is that although you can make an HTTP/2 connection with AWS’s API Gateway, the API Gateway won’t call the lambda over HTTP/2, it will use HTTP/1.1. It seems like this should be easy to overcome, but my understanding is that GRPC is heavily integrated with HTTP/2.

What you’d need is a different wire protocol than GRPC if you wanted to work over HTTP/1.1 and this protocol does exists. It’s called GRPC-Web. Unfortunately, the GRPC-Web clients seems to be limited to JavaScript and TypeScript. There is a Golang client but the “IMPLEMENTATION IS LACKING”. So, unless I missed something, its not possible to run a GRPC service on an AWS Lambda. GRPCWeb is a good compromise if you clients are going to written in JavaScript or if more GRPCWeb clients start appearing. Otherwise you’re probably going to end up with REST or not using Lambdas.

If you found a way to get around this limitation or I missed something then please let me know. My email is below.

More Background:

Earthly makes CI/CD super simple
Fast, repeatable CI/CD with an instantly familiar syntax – like Dockerfile and Makefile had a baby.

Go to our homepage to learn more

Adam Gordon Bell %

Spreading the word about Earthly. Host of CoRecursive podcast. Physical Embodiment of Cunningham’s Law.
✉Email Adam✉


Get notified about new articles!

We won't send you spam. Unsubscribe at any time.