咨询wandb的run_id是否有格式限制及符号禁用规则

run_id格式要求 #

Wandb的run_id存在明确的字符限制，仅允许字母、数字、下划线(_)、连字符(-)，方括号[]、圆括号()这类特殊字符属于非法字符。这是因为run_id会被用于生成API请求路径、本地存储目录名、云端资源标识等，特殊字符会引发路径解析错误、文件系统识别失败或API参数转义异常。

排查线索 #

• 验证run_id合法性：将包含[]的run_id替换为纯合法字符（比如字母+下划线组合），保持其他代码和环境不变重新运行，若图像恢复正常记录，即可确认是特殊字符导致的问题。
• 查看运行日志：检查终端输出的wandb相关日志，搜索Invalid run_id、Failed to upload media、Path resolution error这类关键词，特殊字符引发的错误通常会在日志中给出明确提示。
• 检查本地存储：查看本地wandb/run-<你的run_id>目录，确认该目录是否生成，以及目录内的图像临时文件是否存在、能否正常打开。若目录名包含[]，部分操作系统或文件工具可能无法正确读取该目录，导致上传失败。
• 测试API兼容性：手动测试wandb API对带特殊字符run_id的支持——比如调用获取run详情的接口，传入带[]的run_id，若返回错误或无法找到对应run，即可确认是API参数转义问题导致图像无法上传。

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