fix(ci): build glibc217 packages with devtoolset and new CXX11 ABI

Author: hongzhi-gao

.github/scripts/package-client-cpp-manylinux-glibc217.sh

@@ -14,7 +14,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# Build client-cpp in manylinux2014 and verify max required GLIBC symbol <= 2.17.
+# Build client-cpp in manylinux2014 with devtoolset (new libstdc++ ABI) and verify
+# max required GLIBC symbol <= 2.17.
 set -euxo pipefail
 
 MACHINE=$(uname -m)
@@ -61,7 +62,28 @@ fi
 export PATH="${CMAKE_DIR}/bin:${JAVA_HOME}/bin:${PATH}"
 export JAVA_HOME
 
+# Default container gcc is 4.8 (old libstdc++ ABI). Use devtoolset for GCC 10 + CXX11 ABI.
+DEVTOOLSET_ENABLED=false
+for ds in 10 9 8; do
+  if [[ -f "/opt/rh/devtoolset-${ds}/enable" ]]; then
+    # shellcheck disable=SC1090
+    source "/opt/rh/devtoolset-${ds}/enable"
+    echo "Using devtoolset-${ds}"
+    DEVTOOLSET_ENABLED=true
+    break
+  fi
+done
+if [[ "${DEVTOOLSET_ENABLED}" != true ]]; then
+  echo "WARNING: no devtoolset found; build may use old libstdc++ ABI" >&2
+fi
+
+export CC=gcc
+export CXX=g++
+export CXXFLAGS="${CXXFLAGS:-} -D_GLIBCXX_USE_CXX11_ABI=1"
+export CFLAGS="${CFLAGS:-} -D_GLIBCXX_USE_CXX11_ABI=1"
+
 gcc --version
+g++ --version
 cmake --version
 java -version
 
@@ -73,6 +95,13 @@ cd "${GITHUB_WORKSPACE:?GITHUB_WORKSPACE is not set}"
 SO="iotdb-client/client-cpp/target/install/lib/libiotdb_session.so"
 test -f "${SO}"
 
+echo "=== Verify libstdc++ CXX11 ABI in libiotdb_session.so ==="
+if ! nm -C "${SO}" | grep -q '__cxx11'; then
+  echo "ERROR: libiotdb_session.so does not contain std::__cxx11 symbols (old ABI?)" >&2
+  exit 1
+fi
+nm -C "${SO}" | grep 'Session::Session' | head -3 || true
+
 echo "=== Build host glibc ==="
 ldd --version 2>&1 | sed -n '1p'
 

.github/workflows/client-cpp-package.yml

@@ -162,6 +162,7 @@ jobs:
     needs: [should-package, resolve-matrix]
     if: needs.should-package.outputs.run == 'true' && needs.resolve-matrix.outputs.run_linux == 'true'
     # Checkout/cache on host (Node actions need modern glibc); build in manylinux2014 via docker run.
+    # Script enables devtoolset-10 + new libstdc++ ABI (std::__cxx11); glibc symbols still <= 2.17.
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
@@ -212,6 +213,7 @@ jobs:
     needs: [should-package, resolve-matrix]
     if: needs.should-package.outputs.run == 'true' && needs.resolve-matrix.outputs.run_linux == 'true'
     # Checkout/cache on host; build in manylinux2014 aarch64 via docker run (glibc 2.17 baseline).
+    # Same devtoolset + new libstdc++ ABI as x86_64 glibc217 job.
     runs-on: ubuntu-22.04-arm
     steps:
       - uses: actions/checkout@v5

example/client-cpp-example/README.md

@@ -53,6 +53,10 @@ publishes one zip per platform/toolchain:
 | macOS arm64 | `mac-aarch64` |
 | Windows (match your Visual Studio version) | `windows-x86_64-vs2017` … `vs2026` |
 
+**Linux `linux-*-glibc217` zips** use the **new libstdc++ ABI** (`std::__cxx11`).
+Build these examples with default `g++` on modern Linux; do not add
+`-D_GLIBCXX_USE_CXX11_ABI=0` unless you link against an older SDK artifact.
+
 The current build compiles Thrift 0.21 from source at CMake configure time.
 Legacy `-Diotdb-tools-thrift.version=...` flags applied to the **old**
 pre-built Thrift workflow only; for glibc 2.17 on x86_64 use the

example/client-cpp-example/README_zh.md

@@ -52,6 +52,10 @@ CI 发版（[client-cpp-package.yml](../../.github/workflows/client-cpp-package.
 | macOS arm64 | `mac-aarch64` |
 | Windows + 与工程相同的 VS 版本 | `windows-x86_64-vs2017` … `vs2026` |
 
+**Linux `linux-*-glibc217` 包** 使用 **新版 libstdc++ ABI**（`std::__cxx11`）。
+在现代 Linux 上用默认 `g++` 编译本示例即可，**不要**加
+`-D_GLIBCXX_USE_CXX11_ABI=0`，除非你链接的是更早发布的旧 ABI SDK。
+
 当前 CMake 构建在配置阶段从源码编译 Thrift 0.21，**不再**通过
 `-Diotdb-tools-thrift.version=0.14.1.1-gcc4-SNAPSHOT` 等旧参数控制 glibc；
 x86_64 上若要兼容 glibc 2.17，请使用 `linux-x86_64-glibc217` 包或在

iotdb-client/client-cpp/README.md

@@ -91,6 +91,15 @@ deployment environment:
 Example file name:
 `client-cpp-2.0.7-SNAPSHOT-linux-x86_64-glibc217.zip`.
 
+**Linux `linux-*-glibc217` packages (libstdc++ ABI):** CI builds inside
+`manylinux2014` with **devtoolset-10** and the **new C++11 ABI**
+(`std::__cxx11::…`). Link your application with a normal GCC 5+ toolchain
+(Ubuntu 22.04, Kylin V10, etc.) — you do **not** need
+`-D_GLIBCXX_USE_CXX11_ABI=0`. If you see
+`undefined reference to … std::__cxx11::basic_string …`, you may be using an
+**older** zip built before this change; download a fresh artifact or match ABI
+when linking.
+
 Thrift **0.21.0** is compiled from source during the CMake configure step (see
 `cmake/FetchThrift.cmake`). Older releases that used pre-built
 `iotdb-tools-thrift` Maven artifacts and `-Diotdb-tools-thrift.version=...`
@@ -100,8 +109,8 @@ and OS used to build** the SDK, not by that Maven property.
 
 ### Local build for a specific classifier
 
-Linux x86_64 (glibc 2.17 baseline — use CentOS 7 + devtoolset-8, or any host
-whose glibc is ≤ your deployment target):
+Linux x86_64 (glibc 2.17 baseline — reproduce CI with manylinux2014 +
+devtoolset-10, or any host whose **glibc** is ≤ your deployment target):
 
 ```bash
 mvn -P with-cpp -pl iotdb-client/client-cpp -am -DskipTests \