Linux下gRPC HelloWorld示例二进制体积过大原因及优化咨询

问题背景 #

在Ubuntu 22.04上安装gRPC后编译HelloWorld示例，执行以下命令：

/usr/bin/cmake ../ -DCMAKE_BUILD_TYPE:STRING=MinSizeRel -G "Unix Makefiles"

接着构建：

/usr/bin/cmake --build /home/user/grpc/examples/cpp/helloworld/build --target all -j 8

生成的客户端/服务端二进制文件体积均超过37MB，切换至Release模式体积不变，Debug模式超过40MB（属正常情况）。

个人项目也出现类似问题：未引入gRPC时体积10MB，引入后增至45MB。且项目跨平台，Windows下静态链接生成的exe仅4.5MB，是Linux版本的1/10。

HelloWorld示例的CMakeLists.txt内容如下：

cmake_minimum_required(VERSION 3.5.1)

project(HelloWorld C CXX)

include(../cmake/common.cmake)

# Proto file
get_filename_component(hw_proto "../../protos/helloworld.proto" ABSOLUTE)
get_filename_component(hw_proto_path "${hw_proto}" PATH)

# Generated sources
set(hw_proto_srcs "${CMAKE_CURRENT_BINARY_DIR}/helloworld.pb.cc")
set(hw_proto_hdrs "${CMAKE_CURRENT_BINARY_DIR}/helloworld.pb.h")
set(hw_grpc_srcs "${CMAKE_CURRENT_BINARY_DIR}/helloworld.grpc.pb.cc")
set(hw_grpc_hdrs "${CMAKE_CURRENT_BINARY_DIR}/helloworld.grpc.pb.h")
add_custom_command(
      OUTPUT "${hw_proto_srcs}" "${hw_proto_hdrs}" "${hw_grpc_srcs}" "${hw_grpc_hdrs}"
      COMMAND ${_PROTOBUF_PROTOC}
      ARGS --grpc_out "${CMAKE_CURRENT_BINARY_DIR}"
        --cpp_out "${CMAKE_CURRENT_BINARY_DIR}"
        -I "${hw_proto_path}"
        --plugin=protoc-gen-grpc="${_GRPC_CPP_PLUGIN_EXECUTABLE}"
        "${hw_proto}"
      DEPENDS "${hw_proto}")

# Include generated *.pb.h files
include_directories("${CMAKE_CURRENT_BINARY_DIR}")

# hw_grpc_proto
add_library(hw_grpc_proto
  ${hw_grpc_srcs}
  ${hw_grpc_hdrs}
  ${hw_proto_srcs}
  ${hw_proto_hdrs})
target_link_libraries(hw_grpc_proto
  ${_REFLECTION}
  ${_GRPC_GRPCPP}
  ${_PROTOBUF_LIBPROTOBUF})

# Targets greeter_[async_](client|server)
foreach(_target
  greeter_client greeter_server 
  greeter_callback_client greeter_callback_server 
  greeter_async_client greeter_async_client2 greeter_async_server)
  add_executable(${_target} "${_target}.cc")
  target_link_libraries(${_target}
    hw_grpc_proto
    ${_REFLECTION}
    ${_GRPC_GRPCPP}
    ${_PROTOBUF_LIBPROTOBUF})
endforeach()

体积过大的核心原因 #

1. 链接与编译默认配置差异：Linux下编译gRPC时默认会包含全量功能模块（TLS、HTTP/2、反射等），即使示例未用到也会静态链接进二进制；而Windows版本可能默认裁剪了非必要组件，且MSVC的静态链接冗余代码消除比GCC更彻底。
2. 符号与调试信息残留：Release/MinSizeRel模式下，Linux二进制默认保留了动态链接所需的符号表，未完全剥离，而Windows下MSVC会自动做更多符号裁剪。
3. 系统库依赖：Linux下静态链接glibc等系统库的部分组件，也会增加体积；Windows下系统库多为动态链接，不会纳入exe体积。

缩减体积的可行方案 #

1. 切换为动态链接 #

如果部署允许依赖动态库，编译时链接gRPC和Protobuf的动态版本（.so文件），而非静态库。修改CMake配置，确保_GRPC_GRPCPP、_PROTOBUF_LIBPROTOBUF指向动态库路径，可将体积降至几MB级别（需同步部署对应动态库）。

2. 从源码裁剪gRPC功能 #

重新编译gRPC时关闭非必要模块：

• 禁用TLS（无需加密通信时）：添加CMake选项 -DGRPC_SSL_PROVIDER=none
• 禁用非核心传输/功能：-DGRPC_ENABLE_FORK_SUPPORT=OFF、-DGRPC_BUILD_ZLIB=OFF（使用系统zlib）
• 关闭反射模块：示例中链接了${_REFLECTION}，若无需服务反射，从target_link_libraries中移除该依赖
• 跳过测试与示例编译：-DGRPC_BUILD_TESTS=OFF、-DGRPC_BUILD_EXAMPLES=OFF

3. 添加激进的编译优化选项 #

在CMakeLists中针对Release/MinSizeRel模式添加体积优化：

if(CMAKE_BUILD_TYPE MATCHES "Release|MinSizeRel")
  # GCC/Clang体积优化参数
  target_compile_options(${_target} PRIVATE -Os -ffunction-sections -fdata-sections)
  target_link_options(${_target} PRIVATE -Wl,--gc-sections -Wl,--strip-all)
endif()

• -Os：优先优化体积而非执行速度
• -ffunction-sections/-fdata-sections：将每个函数/数据放入独立段
• -Wl,--gc-sections：链接时删除未使用的段
• -Wl,--strip-all：彻底剥离所有符号表和调试信息

4. 使用Protobuf Lite模式 #

若不需要Protobuf的反射、动态消息等高级功能：

• 在.proto文件顶部添加：option optimize_for = LITE_RUNTIME;
• 将CMake中的链接库从${_PROTOBUF_LIBPROTOBUF}替换为libprotobuf-lite

5. 清理冗余依赖 #

用ldd greeter_client查看动态依赖，或nm -D greeter_client分析符号，确认是否有未使用的库被链接，在CMake中移除对应依赖项。

内容的提问来源于stack exchange，提问作者Dmitry Gorelov