查找问题与解决方法
Sentence Transformers 编码长文时，后半段为什么没起作用？
长文正常返回向量也可能已经截断。检查 max_seq_length、完整 token 数与实际编码长度；切分后核对尾部覆盖，不把调大上限当成长文能力。
systemd-resolved 添加 local 搜索域后把主机名发往单播 DNS
为了让短主机名 printer 自动补成 printer.local，在 resolved.conf 中加入 Domains=local，结果查询被送到普通 DNS 服务器，返回 NXDOMAIN。即使已经设置 MulticastDNS=yes，也没有按预期用 mDNS 找到局域网设备。
sudo 重定向写文件报 Permission denied
sudo 命令后用 > 写入受保护文件仍报 Permission denied，是因为当前 shell 先打开重定向目标。区分 shell、sudo 和 tee 的错误，并按覆盖、追加或编辑配置选择写入方式。
Nginx 代理 localhost 报 [::1] Connection refused，IPv4 后端却能访问
Nginx 日志连接的是 IPv6 回环 ::1，而后端可能只监听 127.0.0.1。通过两种地址的直连结果和监听状态确认，再局部修正上游地址并验证重载。
PHP 引用 foreach 结束后，再次遍历导致数组最后一项被覆盖
PHP 引用遍历结束后，循环变量仍绑定最后一个元素。再次赋值或遍历可能覆盖数组末项；及时 unset 循环变量，并按键和值核对受影响数据。
psycopg2 导入 pandas 报 can’t adapt type numpy.int64：在参数边界转换标量
psycopg2 从 pandas 导入时无法适配 numpy.int64，应检查最终参数并按已验证的整数字段转换为 Python int。保留参数绑定，区分缺失值、整数范围、精度和批次事务。
Docker Compose 报 Additional property include is not allowed
Docker Compose 顶层 include 报不允许时，核对实际插件版本与执行入口，区分文件 version 字段，并用配置校验检查引入文件、路径及资源名称。
LangGraph 并行分支重试时，count_b 报 InvalidUpdateError
并行重试让同一个状态键在一步内被写入多次。检查 return state、字段归属、reducer 语义和汇合边，避免错误消失后计数仍重复。
Docker 本地能构建，Cloud Run 找不到 requirements.txt：检查上传忽略规则
本地 Docker 能构建，Cloud Run 源码构建却找不到 requirements.txt 时，检查 gcloud 上传清单和 .gcloudignore 引入的 Git 忽略规则；用精确例外保留构建文件。
Docker Compose exec 报 the input device is not a TTY
Docker Compose exec 在管道、文件重定向或定时任务中报 the input device is not a TTY。区分伪终端与标准输入，按任务需要使用 -T，并处理通过 stdin 读取 Compose 配置时的交互冲突。
BIND rndc reload 成功却仍返回旧记录：检查区域是否启用了动态更新
BIND 手改区域文件后 reload 成功却仍返回旧记录时，核对动态区域、journal 和 view，选择授权更新入口或受控 freeze/thaw，恢复数据与动态写入。
LangChain 自定义检索器报没有 embeddings 属性
自定义 LangChain 检索器报没有 embeddings 属性，检查 VectorStore 与 Retriever 的对象层次；用 BaseRetriever 包装，并区分 invoke 和实现方法。
SSH 远程命令报 sudo: no tty present：远端没有终端可供输入密码
SSH登录成功但远端sudo无法提示密码，按人工交互与无人值守区分终端分配、非交互失败和有限授权。
Python mock.patch 没有生效：替换被测模块实际查找的名称
mock.patch 已创建但仍调用真实函数时，沿调用表达式定位名称绑定。区分模块顶部 from import、模块属性读取与函数内导入，核对补丁时间和实际调用。
sort file > file 后文件变空：重定向先截断了输入
sort file > file 导致输入变空时，先保留现场和备份；改用独立输出，或在普通 GNU sort 模式使用 -o，并核对原地写入风险。
MongoDB Node.js 的 findOneAndUpdate 更新成功却返回旧文档
原生 Node.js 驱动默认返回更新前文档。区分 returnDocument 与 includeResultMetadata，并按实际版本修正选项和结果读取，避免误重试写入。
Python dataclass 继承后报 non-default argument follows default argument
dataclass 继承后的默认字段与必填字段顺序冲突，会在类定义阶段报错。用 Python 3.10 起支持的 keyword-only 字段处理，并检查构造签名、位置参数与模式匹配兼容性。
git stash -u 后，stash show 看不到未跟踪文件
git stash -u 保存后，stash show 默认可能看不到未跟踪文件。Git 2.32 起可用 include-untracked 或 only-untracked 查看；旧版读取第三父提交，并在恢复前确认条目、路径和保存范围。
PostgreSQL 调用 round 报 double precision, integer 函数不存在
PostgreSQL 的双参数 round 要求 numeric，浮点计算结果需在函数内部转换。用 pg_typeof 核对类型，并区分转换前后的运算精度和整数除法。
Docker COPY 使用通配符后，符号链接变成普通文件
BuildKit 直接选中的源链接会被解引用。改为复制专用父目录，保留目录内部链接及目标布局，并检查多阶段产物、绝对链接和最终文件类型。