PAYATHON 2026

Docker 中 DevExpress 的 DX1001 和报告水印如何排查？

数据小陈

结论

DX1001 表示构建时未找到可识别的 DevExpress 许可证密钥。DevExpress 文档建议在 Docker 构建阶段通过 ARG DevExpress_License 传入密钥，或将密钥文件放在 Linux 默认路径 $HOME/.config/DevExpress/DevExpress_License.txt。如果 ARG 在 dotnet build 之前已声明，且密钥文件写入了执行构建的用户家目录，通常无需将个人许可证密钥放进最终运行镜像。DevExpress 会在构建验证时将 DXLicenseInformationAttribute 写入程序集，并明确建议不要在生产环境随应用发布个人许可证密钥。DevExpress 许可证密钥文档

目前的信息不足以确定报告横幅出现的具体原因。先确认构建使用的密钥和包版本，再检查最终发布的程序集是否来自成功识别许可证的构建。

排查构建警告

DX1001 表示构建器未识别到许可证。Linux 中路径和变量名区分大小写，名称必须准确写为 DevExpress_License.txt 和 DevExpress_License。还要确认文件写入的 $HOME 与执行 dotnet build 的用户家目录一致，并确保创建文件的 RUN 指令和构建命令位于同一个 Docker 构建阶段。官方列出的 Linux 默认路径是 $HOME/.config/DevExpress/DevExpress_License.txt。许可证注册与错误代码说明

诊断时不要用 cat 输出许可证内容。只检查文件是否非空、变量名是否准确，然后在不将密钥写入日志的情况下重新构建。也要核对日志中的警告代码：官方将 DX1001 定义为未找到密钥，DX1000 则与使用试用版产品库有关。若日志实际显示 DX1000，排查方向也应随之调整。

如果使用 BuildKit，可以通过构建密钥挂载文件，避免将许可证内容写入镜像层：

# BuildKit Dockerfile syntax
FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
COPY ["MyApi/MyApi.csproj", "MyApi/"]
RUN dotnet restore "MyApi/MyApi.csproj"
COPY . .
WORKDIR "/src/MyApi"
RUN --mount=type=secret,id=DEVEXPRESS_LICENSE \
    mkdir -p "$HOME/.config/DevExpress" && \
    cp /run/secrets/DEVEXPRESS_LICENSE "$HOME/.config/DevExpress/DevExpress_License.txt" && \
    dotnet build "MyApi.csproj" -c Release -o /app/build

构建时提供密钥文件：

docker build --secret=id=DEVEXPRESS_LICENSE,src=DevExpress_License.txt -t myapi .

DevExpress 的 Docker 示例也使用 BuildKit secret，在执行 dotnet build 时临时挂载许可证文件。DevExpress Docker 示例

检查运行时报告横幅

DevExpress 文档要求在构建阶段提供许可证密钥，并说明个人密钥无需随应用发布给最终用户。因此，不建议将密钥复制到运行阶段或作为运行时环境变量部署。如果运行时仍显示横幅，先确认最终镜像中的应用程序集来自使用有效密钥构建的产物，并检查当前运行的是否为旧镜像或旧发布产物。还要确认项目引用的 DevExpress 产品库已获授权；试用版可能会在运行时和导出的文档中显示水印。试用版与运行时水印说明

构建完成后，可以检查程序集是否包含 DXLicenseInformationAttribute。该特性记录许可证密钥的哈希信息，不含个人身份信息。如果特性缺失，或构建日志仍报告 DX1001，应先修复构建时的密钥识别问题，再重新生成并部署应用程序集。

版本与权限

仅凭现有信息，无法判断某个 DevExpress NuGet 包版本是否更适合 Docker。请记录实际使用的 .NET、DevExpress 和 NuGet 包版本，并确认许可证密钥适用于这些产品及版本。官方指出，较旧的密钥可能与较新的主版本不兼容；可以结合实际的 DX10XX 代码判断具体问题。许可证错误代码说明

文件权限也可能导致构建用户无法读取许可证，但现有描述不能证明这是当前故障原因。如果构建阶段切换过用户，请检查文件属主和读取权限，并确认执行构建时密钥文件仍可读。不要将个人许可证提交到代码仓库、写入最终镜像或输出到构建日志。

备注：内容仅供参考。