利用golang embed特性嵌入前端资源问题解决

embed嵌入前端资源,配置前端路由的代码如下

复制代码
func StartHttpService(port string, assetsFs embed.FS) error {
	//r := gin.Default()
	gin.SetMode(gin.ReleaseMode)
	r := gin.New()
	r.Use(CORSMiddleware())

	// 静态文件服务
	dist, err := fs.Sub(assetsFs, "assets/dist")
	if err != nil {
		return fmt.Errorf("无法加载静态文件: %v", err)
	}
	r.StaticFS("/", http.FS(dist))

	// API路由
	r.Any("/api/service", handler.ServiceControlsHandler)
	r.Any("/api/service/config", handler.ServiceConfigsHandler)

	// 处理前端路由
	r.NoRoute(func(c *gin.Context) {
		c.FileFromFS("index.html", http.FS(dist))
	})

	go func() {
		common.Logger.Info(fmt.Sprintf("Web服务正在启动,监听端口 :%s", port))
		err := r.Run(":" + port)
		if err != nil {
			common.Logger.Error(fmt.Sprintf("http service start error: %v", err))
		} else {
			common.Logger.Info("http service start success")
		}
	}()
	return nil
}

运行后报错

复制代码
panic: '/api/service' in new path '/api/service' conflicts with existing wildcard '/*filepath' in existing prefix '/*filepath'

问题解决步骤:

  1. 分析错误原因
    在Gin框架中,路由注册顺序和路径模式会导致冲突。当前代码在注册/api/service路由时,与之前注册的通配符路由/*filepath发生冲突。Gin不允许在同一个路径前缀上注册多个处理函数。
  2. 确定解决方案
    为了解决路由冲突问题,需要调整前端路由的基路径:
  • 将根路径/重定向到/admin
  • 修改前端构建配置,将静态资源的基路径设为/admin
  1. 修改Golang代码
    StartHttpService函数中:

    • 添加根路径重定向:
      go 复制代码
      r.GET("/", func(c *gin.Context) {
          c.Redirect(http.StatusMovedPermanently, "admin/")
      })
  • 修改静态文件服务路径:

    r.StaticFS("/admin", http.FS(dist))

  1. 修改前端配置
    vite.config.js中添加base配置:

    import { defineConfig } from 'vite'
    import vue from '@vitejs/plugin-vue'
    export default defineConfig({
    plugins: [vue()],
    base: '/admin/',
    })

  2. 重新构建前端资源
    执行npm run build生成新的静态资源,并确保生成的文件与/admin路径匹配。

  3. 验证生效
    重新启动服务后:

  • 访问根路径/会自动跳转到/admin
  • 前端路由和API路由将正常工作,不会有路径冲突
    此方案通过调整路由结构和前端配置,解决了Gin框架中的路由冲突问题,同时保持了前端应用的正常功能。
相关推荐
小白变怪兽1 小时前
一、react18+项目初始化(vite)
前端·react.js
ai小鬼头1 小时前
AIStarter如何快速部署Stable Diffusion?**新手也能轻松上手的AI绘图
前端·后端·github
墨菲安全2 小时前
NPM组件 betsson 等窃取主机敏感信息
前端·npm·node.js·软件供应链安全·主机信息窃取·npm组件投毒
GISer_Jing2 小时前
Monorepo+Pnpm+Turborepo
前端·javascript·ecmascript
天涯学馆2 小时前
前端开发也能用 WebAssembly?这些场景超实用!
前端·javascript·面试
我在北京coding3 小时前
TypeError: Cannot read properties of undefined (reading ‘queryComponents‘)
前端·javascript·vue.js
前端开发与ui设计的老司机4 小时前
UI前端与数字孪生结合实践探索:智慧物流的货物追踪与配送优化
前端·ui
全能打工人4 小时前
前端查询条件加密传输方案(SM2加解密)
前端·sm2前端加密
翻滚吧键盘4 小时前
vue绑定一个返回对象的计算属性
前端·javascript·vue.js
秃了也弱了。5 小时前
Chrome谷歌浏览器插件ModHeader,修改请求头,开发神器
前端·chrome