Athens无法识别本地磁盘存储，求安装及问题排查指导

一、确认存储目录结构合规性 #

Athens的磁盘存储要求包文件严格遵循模块路径+版本号的层级结构，直接放入解压后的源码文件夹无效。以github.com/gin-gonic/gin的v1.9.0版本为例，正确结构应为：

<你的存储根目录>/github.com/gin-gonic/gin/@v/v1.9.0.info
<你的存储根目录>/github.com/gin-gonic/gin/@v/v1.9.0.mod
<你的存储根目录>/github.com/gin-gonic/gin/@v/v1.9.0.zip

• Athens仅识别上述三个核心文件，源码文件夹无法被直接读取
• 若只有本地源码，需手动生成.info和.mod文件，或通过go mod download命令让Athens自动拉取并生成标准结构

二、检查.toml配置有效性 #

确保存储配置无语法错误，优先使用绝对路径：

[Storage]
type = "disk"

[Storage.Disk]
RootPath = "/绝对路径/到/你的存储目录"

• 修改配置后必须重启Athens服务，使其加载新配置
• 查看Athens启动日志，确认已成功加载指定的存储目录

三、修正请求路径格式 #

Athens的请求路由基于模块路径和版本号，而非文件系统路径，正确请求格式为：

http://localhost:端口号/<模块路径>@<版本号>

示例：http://localhost:3000/github.com/gin-gonic/gin@v1.9.0

四、手动导入本地包的标准步骤 #

1. 确保本地包已初始化Go模块（存在go.mod文件）
2. 在本地包目录执行go list -m -json，将输出内容写入.info文件（命名为<版本号>.info）
3. 复制go.mod文件并重命名为<版本号>.mod
4. 将源码打包为<版本号>.zip压缩包
5. 按照模块路径层级，将上述三个文件放入存储目录对应位置
6. 重启Athens后发起请求

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