3.8 KiB
3.8 KiB
title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit
| title | type | permalink | stable_id | scope | project_id | workspace_type | usage_profile_id | preference_context | document_type | revision | source_memory_ids | source_checkpoint_ids | source_file_ids | source_git_commit | source_git_commits | source_agent_sync_ids | model_connection | model_name | source_count | source_revisions | source_dispositions | cited_source_ids | job_cited_source_ids | conflicts | supersedes | preferences | source_cursor | source_hash | prompt_version | schema_version | curation_job_id | created_at | updated_at | tags | restored_from_commit | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| HanteleWorkTime 常见问题排查指南 | curated | main/projects/6553b53c-bf14-49e3-a3de-1ee2f3533d51/curated/development/hantele-work-time-常见问题排查指南 | 6086d60a-bd33-4823-9117-10e1fdae2767 | project | 6553b53c-bf14-49e3-a3de-1ee2f3533d51 | development | null | development | troubleshooting | 1 | null | Sub2API | git-restore | 13 |
|
|
|
207 | 5a2bf7e4aa8a90513e133f70e1737cdaf99fddd9888166c7645ba4700934109c | 2026-08-12.3 | 3 | null | 2026-08-31T03:10:09.738999+00:00 | 2026-09-23T14:56:42.119559+00:00 |
|
6a6a895eaf |
常见问题及解决方案
| 场景 | 症状 | 可能原因 | 解决办法 |
|---|---|---|---|
| FastAPI 异步阻塞 | 请求卡死，日志无响应 | 在 async def 中调用阻塞 I/O（如 pymysql、requests） |
将函数改为普通 def，让 FastAPI 自动切换至线程池。 |
| PowerShell 发送 JSON | 服务器收到的 JSON 丢失引号 | 直接在命令行中使用 --data 导致引号被解析 |
先将 JSON 写入临时文件，然后使用 --data-binary @file 发送。 |
| Docker Exec 超时 | 长时间交互式命令在 3 秒后断开 | docker-py 默认全局超时被继承到 hijacked socket |
在获取裸 socket 后调用 socket.settimeout(None)，保持无限阻塞。 |
| Docker Hub 连接失败 | docker pull 报错或长时间卡住 |
Docker Desktop 代理未配置为 Manual 或代理地址错误 | 打开 Docker Desktop → Settings → Resources → Proxies，手动填写 http://127.0.0.1:7897，保存并重启 Docker。 |
| Vaultwarden 凭证未自动使用 | 登录或 API 调用仍要求手动输入凭证 | 搜索到多条或无匹配记录 | 确认 Vaultwarden 中仅保留唯一条目；若有多条，手动选择或删除冗余。 |
| Docker 容器网络不可达宿主服务 | 容器内访问 localhost 失败 |
容器默认隔离网络 | 使用 host.docker.internal（Windows/macOS）或在 docker run 时添加 --network host（Linux）访问宿主。 |
| 脚本换行符导致错误 | $'\r': command not found |
脚本使用 Windows CRLF 换行 | 将脚本转换为 LF 换行（dos2unix 或编辑器设置）后重新执行。 |
参考来源：global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56, global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0, global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5, global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d, global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316.
标签: ["development", "troubleshooting"]