查找问题与解决方法
Docker Compose 使用 network_mode: service 时发布端口报冲突
Web 容器使用 network_mode: service:db 后，独立配置 ports 会触发 port publishing 与 container type network mode 冲突。将映射移到网络提供方，并检查监听地址、容器重建与数据库就绪条件。
Kubernetes Secret 报 illegal base64 data：先核对真正提交的清单
Kubernetes Secret 创建报非法 Base64 时，核对真正提交的文件与 data 字段，区分 stringData、编码文本换行和原始凭据换行，保留更新与隐私边界。
Dockerfile ADD 下载 tar.gz 后没有生成解压目录
远程 ADD 默认只下载归档，本地 tar 默认展开。核对来源类型、包内层级，并在 Dockerfile 1.17 及兼容构建器中显式使用 --unpack。
WireGuard 加第二个客户端后第一个不通：每个客户端需要独立 Peer
WireGuard 加手机后笔记本不通，先核对独立 Peer 段、运行中公钥与隧道地址，再区分客户端默认路由和服务器对端归属。
合并多个 Compose 文件后，env_file 指向了错误目录
多个 -f 合并 Compose 配置时，env_file 相对路径统一按第一个文件解析。定位错误目录，并用明确路径或目录前缀兼顾整体部署与后端独立使用。
Docker Desktop 的 MongoDB 容器无法从宿主机连接：EXPOSE 没有发布端口
Docker Desktop 上 MongoDB 容器运行却无法从宿主机连接，区分 EXPOSE 和发布端口，保留数据与认证后修改原部署映射。
grep -I 仍提示 Binary file matches：检查编码与 NUL 判断
GNU grep 使用 -I 仍提示 Binary file matches 时，区分 NUL 与 locale 编码判断，按字节搜索或受控文本输出，保留原始数据。
PostgreSQL 的 SELECT DISTINCT 报 ORDER BY expressions must appear in select list
SELECT DISTINCT 只输出去重键，却按未输出的字段排序时，PostgreSQL 会拒绝查询。按结果含义选择分组聚合或 DISTINCT ON，避免补列后重新出现重复，以及关联表 id 覆盖主键。