使用curl调用Fastify HTTP2服务器时无法查看请求输出的问题求助

我来帮你拆解下遇到的两个问题，以及对应的解决办法：

1. 初始curl命令返回二进制数据的原因 #

你最初的curl命令参数顺序出了问题：

curl -kvso --http2 http://0.0.0.0:3000/health -H "Accept: application/json" -H "Content-type: application/json" --output response.json

-kvso是组合参数，其中-o需要紧跟输出文件名，但你把--http2放在了-o之后，导致curl错误地将--http2当作了输出文件，后续的--output response.json虽然指定了正确文件，但参数解析混乱已经让响应数据传输格式异常，最终response.json里出现无法解析的二进制内容。

正确的参数顺序应该是把输出文件参数放在目标URL之前：

curl -kv --http2 -o response.json http://0.0.0.0:3000/health -H "Accept: application/json" -H "Content-type: application/json"

2. 使用--http2-prior-knowledge后请求卡住的原因 #

Fastify中仅设置http2: true时，默认会创建基于TLS的HTTP2服务器（h2协议），它需要SSL证书才能正常工作。但你既没配置TLS证书，又用http://发起明文请求，导致服务器在等待TLS握手，而curl在尝试明文HTTP2连接，双方协议不匹配，最终陷入卡住状态。

解决方案 #

根据你的需求，有两种可行的配置方式：

方案一：启用带TLS的HTTP2（生产环境推荐）

HTTP2在生产环境通常结合TLS使用，你需要生成自签名证书并配置Fastify：

1. 用openssl生成自签名证书：

openssl req -x509 -newkey rsa:4096 -keyout server.key -out server.cert -days 365 -nodes

执行后当前目录会生成server.key和server.cert两个文件。

2. 修改Fastify代码，配置HTTPS和HTTP2：

const fs = require('fs');
const fastify = require('fastify')({
  http2: true,
  https: {
    key: fs.readFileSync('./server.key'),
    cert: fs.readFileSync('./server.cert')
  }
});

// 你的健康检查路由
fastify.get('/health', async (req, reply) => {
  return { status: 'ok' };
});

fastify.listen({ port: 3000 }, (err) => {
  if (err) throw err;
  console.log('Server running on https://0.0.0.0:3000');
});

3. 用curl发起HTTPS的HTTP2请求：

curl --http2 -kv -o response.json https://0.0.0.0:3000/health -H "Accept: application/json" -H "Content-type: application/json"

-k参数用于忽略自签名证书的安全警告，生产环境请使用可信证书。

方案二：启用明文HTTP2（h2c，仅用于测试）

如果只是本地测试，不需要TLS，可以配置Fastify支持明文HTTP2，同时允许HTTP1回退：

1. 修改Fastify代码：

const fastify = require('fastify')({
  http2: true,
  allowHTTP1: true // 允许HTTP1请求，同时支持明文HTTP2
});

// 你的健康检查路由
fastify.get('/health', async (req, reply) => {
  return { status: 'ok' };
});

fastify.listen({ port: 3000 }, (err) => {
  if (err) throw err;
  console.log('Server running on http://0.0.0.0:3000 (h2c enabled)');
});

2. 用curl发起明文HTTP2请求：

curl --http2-prior-knowledge -kv -o response.json http://0.0.0.0:3000/health -H "Accept: application/json" -H "Content-type: application/json"

--http2-prior-knowledge参数告诉curl直接使用HTTP2协议连接，不需要先通过HTTP1升级。

这样就能正常获取服务器返回的JSON响应了。

内容的提问来源于stack exchange，提问作者Antonio Gamiz Delgado