如何解决Haskell应用Docker容器化后的运行故障

问题根因 #

两个报错的核心诱因如下：

• runapp.sh找不到：一是脚本未配置可执行权限，exec格式的CMD指令无法执行无执行位的文件，会直接抛出文件不存在错误；二是["app/runapp.sh"]路径配置错误，WORKDIR已指定为/app，该路径实际指向/app/app/runapp.sh，不存在对应文件。
• 找不到Data.Aeson模块：cabal v2-build为沙盒化构建，所有依赖存储在cabal独立沙盒目录，不会全局注册到GHC包搜索路径。直接手动调用ghci/ghc时不会加载cabal沙盒环境，自然无法识别沙盒内安装的依赖。
• 硬编码的dist-newstyle二进制路径稳定性极差，会随GHC版本、包版本、系统架构自动生成，版本变动就会失效。

修复步骤 #

1. 修正启动脚本 #

修改本地runapp.sh内容，去掉硬编码路径，在脚本开头指定shell解释器，通过cabal调用可执行文件：

#!/bin/bash
cabal v2-run app

注意把app替换为你.cabal文件中定义的可执行程序名。

给本地脚本添加可执行权限：

chmod +x runapp.sh

2. 替换Dockerfile内容 #

优化后的Dockerfile会提前缓存依赖、自动配置权限、将可执行文件安装到全局固定路径，避免路径和依赖问题：

FROM haskell:8

WORKDIR /app

# 先复制cabal配置文件，提前拉取依赖，利用Docker构建缓存加速后续构建
COPY *.cabal cabal.project.freeze ./
RUN cabal update && cabal v2-build --only-dependencies -j$(nproc)

# 复制全量项目代码
COPY . .

# 构建项目并将可执行文件安装到全局PATH目录，无需再找dist-newstyle下的动态路径
RUN cabal v2-build && cabal v2-install --installdir=/usr/local/bin

EXPOSE 8081

# 直接启动全局安装的可执行文件，也可以替换为 ["./runapp.sh"] 使用脚本启动
CMD ["app"]

3. 可选优化：多阶段构建缩小镜像体积 #

如果不需要在运行镜像中保留GHC、cabal等构建工具，可以使用多阶段构建将最终镜像体积从几GB缩小到百MB级别：

# 构建阶段
FROM haskell:8 AS builder
WORKDIR /app
COPY *.cabal cabal.project.freeze ./
RUN cabal update && cabal v2-build --only-dependencies -j$(nproc)
COPY . .
RUN cabal v2-install --installdir=/opt/build

# 运行阶段
FROM debian:stable-slim
RUN apt-get update && apt-get install -y --no-install-recommends libgmp10 libc6 && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=builder /opt/build/* /usr/local/bin/
EXPOSE 8081
CMD ["app"]

验证说明 #

• 构建镜像后直接执行docker run -p 8081:8081 你的镜像名即可正常启动服务
• 如果需要进入容器调试，不要直接运行ghci，改用cabal v2-exec ghci即可自动加载沙盒依赖，不会出现找不到模块的错误

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