langgenius/dify · error · Error

Invalid dev proxy route path "${path}". Paths must start wit

Error message

Invalid dev proxy route path "${path}". Paths must start with "/".

What it means

Error "Invalid dev proxy route path "${path}". Paths must start with "/"." thrown in langgenius/dify.

Source

Thrown at packages/dev-proxy/src/server.ts:438

  return (request: IncomingMessage, clientSocket: Duplex, head: Buffer) => {
    try {
      handleUpgrade(request, clientSocket, head)
    } catch (error) {
      logger.error('[dev-proxy]', error)
      if (!clientSocket.destroyed) closeUpgradeRequest(clientSocket, 502, 'Bad Gateway')
    }
  }
}

const registerProxyRoute = (
  app: Hono,
  route: DevProxyRoute,
  path: string,
  fetchImpl: typeof globalThis.fetch,
  allowedOrigins: DevProxyCorsAllowedOrigins,
) => {
  if (!path.startsWith('/'))
    throw new Error(`Invalid dev proxy route path "${path}". Paths must start with "/".`)

  app.all(path, (context) => proxyRequest(context, route, fetchImpl, allowedOrigins))
  app.all(`${path}/*`, (context) => proxyRequest(context, route, fetchImpl, allowedOrigins))
}

const registerProxyRoutes = (
  app: Hono,
  routes: readonly DevProxyRoute[],
  fetchImpl: typeof globalThis.fetch,
  allowedOrigins: DevProxyCorsAllowedOrigins,
) => {
  routes.forEach((route) => {
    normalizeRoutePaths(route.paths).forEach((path) => {
      registerProxyRoute(app, route, path, fetchImpl, allowedOrigins)
    })
  })
}

View on GitHub (pinned to ef8544b173)

When it happens

Trigger: Thrown at packages/dev-proxy/src/server.ts:438 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of langgenius/dify@ef8544b173 (2026-08-12). Data as JSON: /api/errors/32c585d1bcf67de0. Report an issue: GitHub.