答案：本文介绍如何用Golang开发音乐播放接口，定义Music结构体并使用net/http包创建路由，实现返回JSON格式音乐列表及按ID查询单曲功能。
开发一个音乐播放接口的核心在于设计合理的路由、解析前端传来的请求数据，并正确返回 JSON 格式的音乐信息。Golang 凭借其高效的性能和简洁的语法，非常适合用来构建这类轻量级 API 服务。本文将带你一步步实现一个基于 Golang 的音乐播放接口，重点讲解如何定义结构体、处理 HTTP 请求以及解析和返回 JSON 数据。
定义音乐数据结构
在开始编写接口逻辑之前，先明确音乐数据的格式。通常一首音乐包含标题、歌手、专辑、时长、封面地址等字段。我们可以用 Go 的结构体来映射这些数据：
type Music struct {
ID int `json:"id"`
Title string `json:"title"`
Artist string `json:"artist"`
Album string `json:"album"`
Duration int `json:"duration"` // 单位：秒
Cover string `json:"cover"`
URL string `json:"url"` // 音频文件地址
}
使用 json 标签 可以让结构体在序列化和反序列化时与 JSON 字段对应。例如，外部看到的是 "title"，内部使用 Title。
搭建 HTTP 路由与接口响应
Go 的 net/http 包足够支撑基础的 Web 接口开发。我们注册一个 GET 接口用于获取音乐列表：
立即学习“go语言免费学习笔记（深入）”；
func musicHandler(w http.ResponseWriter, r *http.Request) {
musicList := []Music{
{ID: 1, Title: "晴天", Artist: "周杰伦", Album: "叶惠美", Duration: 240, Cover: "/covers/qingtian.jpg", URL: "/music/qingtian.mp3"},
{ID: 2, Title: "七里香", Artist: "周杰伦", Album: "七里香", Duration: 260, Cover: "/covers/qilixiang.jpg", URL: "/music/qilixiang.mp3"},
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(musicList)
}
func main() {
http.HandleFunc("/api/music", musicHandler)
http.ListenAndServe(":8080", nil)
}
启动服务后访问 http://localhost:8080/api/music 就能拿到 JSON 格式的音乐列表。注意设置响应头为 application/json，避免浏览器下载文件。
支持按 ID 查询单首歌曲
实际应用中常需要根据 ID 获取特定歌曲。可以通过解析 URL 查询参数实现：
func musicDetailHandler(w http.ResponseWriter, r *http.Request) {
idStr := r.URL.Query().Get("id")
id, err := strconv.Atoi(idStr)
if err != nil || id <= 0 {
http.Error(w, "无效的 ID", http.StatusBadRequest)
return
}
// 模拟查找
for _, m := range musicList {
if m.ID == id {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(m)
return
}
}
http.Error(w, "未找到该歌曲", http.StatusNotFound)
}
将这个处理器注册到 /api/music/detail 路径，就可以通过 /api/music/detail?id=1 获取具体歌曲信息。
处理 POST 请求上传音乐信息
如果需要支持添加新歌曲，可以接收前端发送的 JSON 数据并解析：
func addMusicHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持 POST 方法", http.StatusMethodNotAllowed)
return
}
var newMusic Music
err := json.NewDecoder(r.Body).Decode(&newMusic)
if err != nil {
http.Error(w, "JSON 解析失败", http.StatusBadRequest)
return
}
// 简单模拟存储（实际可写入数据库）
newMusic.ID = len(musicList) + 1
musicList = append(musicList, newMusic)
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(newMusic)
}
前端发送正确的 JSON 数据，服务端就能成功解析并返回新增的音乐对象。
基本上就这些。通过定义结构体、合理使用 net/http 和 encoding/json 包，Golang 能快速实现一个功能完整的音乐播放接口。不复杂但容易忽略细节，比如 MIME 类型设置、错误处理和参数校验。
