WRF-Hydro在Ubuntu 22.04 LTS上的系统化编译与部署指南

1. 环境准备与系统配置

在开始WRF-Hydro的编译安装之前，我们需要确保Ubuntu 22.04 LTS系统已经做好了充分准备。我建议使用全新的系统环境，这样可以避免各种依赖冲突问题。实测下来，8GB内存和50GB存储空间是最低配置要求，如果条件允许，16GB内存会让编译过程更加顺畅。

首先更新系统软件包是个好习惯：

sudo apt update && sudo apt upgrade -y

接下来安装基础编译工具链，这是后续所有工作的基石：

sudo apt install -y gcc g++ gfortran make cmake

我习惯创建一个专门的项目目录来管理所有相关文件，这样可以保持工作区整洁：

mkdir -p ~/wrf_hydro_project/{sources,apps} export SOURCES=~/wrf_hydro_project/sources export APPS=~/wrf_hydro_project/apps

注意：建议将上述环境变量写入~/.bashrc文件，这样每次打开新终端时都会自动加载。可以使用echo "export SOURCES=~/wrf_hydro_project/sources" >> ~/.bashrc这样的命令来追加。

2. 依赖库的编译与安装

2.1 MPICH并行计算环境

WRF-Hydro需要MPI并行计算支持，我们选择MPICH作为实现方案。最新稳定版是4.1.2，下载和安装步骤如下：

wget -P $SOURCES https://www.mpich.org/static/downloads/4.1.2/mpich-4.1.2.tar.gz tar -xzf $SOURCES/mpich-4.1.2.tar.gz -C $SOURCES cd $SOURCES/mpich-4.1.2 ./configure --prefix=$APPS/mpich --enable-fast=all make -j$(nproc) make install

这里有几个实用技巧：

• -j$(nproc)参数会使用所有CPU核心进行编译，大幅加快速度
• 如果遇到权限问题，可以在configure时加上--enable-shared选项
• 安装完成后记得将MPICH加入PATH：export PATH=$APPS/mpich/bin:$PATH

2.2 NetCDF及其依赖库

NetCDF是WRF-Hydro的核心依赖，需要先安装zlib和HDF5。这里我推荐使用统一的安装前缀：

# 安装zlib wget -P $SOURCES https://www.zlib.net/zlib-1.2.13.tar.gz tar -xzf $SOURCES/zlib-1.2.13.tar.gz -C $SOURCES cd $SOURCES/zlib-1.2.13 ./configure --prefix=$APPS/netcdf make -j$(nproc) make install # 安装HDF5 wget -P $SOURCES https://support.hdfgroup.org/ftp/HDF5/releases/hdf5-1.12/hdf5-1.12.2/src/hdf5-1.12.2.tar.gz tar -xzf $SOURCES/hdf5-1.12.2.tar.gz -C $SOURCES cd $SOURCES/hdf5-1.12.2 ./configure --prefix=$APPS/netcdf --with-zlib=$APPS/netcdf --enable-hl --enable-fortran make -j$(nproc) make install

NetCDF需要分C和Fortran两个版本安装，这里有个坑我踩过多次：必须先设置好环境变量：

export CPPFLAGS="-I$APPS/netcdf/include" export LDFLAGS="-L$APPS/netcdf/lib" export LD_LIBRARY_PATH="$APPS/netcdf/lib:$LD_LIBRARY_PATH"

然后安装NetCDF-C：

wget -P $SOURCES https://downloads.unidata.ucar.edu/netcdf-c/4.9.2/netcdf-c-4.9.2.tar.gz tar -xzf $SOURCES/netcdf-c-4.9.2.tar.gz -C $SOURCES cd $SOURCES/netcdf-c-4.9.2 ./configure --prefix=$APPS/netcdf --disable-dap make -j$(nproc) make install

最后安装NetCDF-Fortran：

wget -P $SOURCES https://downloads.unidata.ucar.edu/netcdf-fortran/4.6.1/netcdf-fortran-4.6.1.tar.gz tar -xzf $SOURCES/netcdf-fortran-4.6.1.tar.gz -C $SOURCES cd $SOURCES/netcdf-fortran-4.6.1 ./configure --prefix=$APPS/netcdf make -j$(nproc) make install

3. 环境变量配置

所有依赖安装完成后，需要正确配置环境变量。我建议将这些设置永久保存在~/.bashrc中：

echo "export PATH=$APPS/mpich/bin:$APPS/netcdf/bin:\$PATH" >> ~/.bashrc echo "export NETCDF=$APPS/netcdf" >> ~/.bashrc echo "export LD_LIBRARY_PATH=$APPS/netcdf/lib:$APPS/mpich/lib:\$LD_LIBRARY_PATH" >> ~/.bashrc source ~/.bashrc

验证安装是否成功：

nc-config --all # 检查NetCDF配置 mpiexec --version # 检查MPICH安装

4. WRF-Hydro本体编译

4.1 获取源代码

推荐从官方GitHub仓库获取最新稳定版：

wget -P $SOURCES https://github.com/NCAR/wrf_hydro_nwm_public/archive/refs/tags/v5.2.0.tar.gz tar -xzf $SOURCES/v5.2.0.tar.gz -C $SOURCES cd $SOURCES/wrf_hydro_nwm_public-5.2.0/trunk/NDHMS

4.2 配置编译环境

复制并修改环境配置模板：

cp template/setEnvar.sh . sed -i 's/export WRF_HYDRO=0/export WRF_HYDRO=1/' setEnvar.sh echo "export WRFIO_NCD_LARGE_FILE_SUPPORT=1" >> setEnvar.sh source setEnvar.sh

4.3 编译安装

运行配置脚本：

./configure

选择选项2（Linux系统，gfortran编译器），然后开始编译：

./compile_offline_NoahMP.sh setEnvar.sh > compile.log 2>&1 & tail -f compile.log

编译过程可能需要30分钟到2小时不等，取决于硬件性能。如果一切顺利，最后会看到"Executables successfully built"的消息。生成的运行文件位于Run目录下。

5. 常见问题排查

在实际项目中，我遇到过几个典型问题：

1. HDF5版本兼容性问题：如果遇到奇怪的链接错误，尝试使用HDF5 1.10.x版本而非最新版。Ubuntu 22.04的默认库有时会冲突。

2. 内存不足导致编译失败：可以尝试减少并行编译线程数：make -j4代替make -j$(nproc)

3. Fortran模块加载错误：确保NetCDF-Fortran安装正确，环境变量中包含了Fortran库路径

4. MPI通信错误：测试MPICH是否正常工作：mpiexec -n 4 hostname应该能输出4行主机名

对于更复杂的问题，建议查看config.log和compile.log中的详细错误信息。WRF-Hydro社区论坛也是很好的求助资源。