根本原因是Laravel未读取到ASSET_URL配置值，常见于未执行php artisan config:clear、ASSET_URL末尾误加斜杠、混用asset()与mix()却只配一个变量、CDN路径结构与public目录不一致或部署时.env未同步。
asset() 函数不走 CDN 的根本原因
绝大多数人配置完 CACHE_URL 或 ASSET_URL 后，asset('css/app.css') 依然输出本地地址，核心问题就一个：Laravel 没读到你设的值。常见原因包括：
-
php artisan config:clear没执行，缓存配置覆盖了.env新值 -
.env中写成了ASSET_URL=https://cdn.example.com/（末尾斜杠），导致拼接后变成https://cdn.example.com//css/app.css，部分 CDN 会 404 - 用了
mix()却只配了ASSET_URL，而mix()实际读的是MIX_ASSET_URL，两者必须分开配 - 服务器部署时没同步
.env文件，或权限导致 Laravel 无法读取
Laravel Mix 和 Vite 的 CDN 路径差异
同一项目混用 asset() 和 mix() 或 @vite 时，CDN 配置不能“一招鲜”。它们各自认不同的环境变量：
-
asset()只响应ASSET_URL（或APP_URL，但不推荐用它管静态资源） -
mix()默认读MIX_ASSET_URL；若在webpack.mix.js里调用了.setPublicPath('https://cdn.example.com')，则优先用这个 -
@vite依赖vite.config.js中的base选项，且需配合MIX_ASSET_URL（Vite 插件会读它）或手动判断环境
示例（vite.config.js）：
export default defineConfig({
base: process.env.APP_ENV === 'production'
? 'https://cdn.example.com/'
: '/',
})
CDN 域名路径结构必须严格匹配 public 目录
这是上线后 404 最高频的坑。Laravel 的 asset() 是纯字符串拼接：ASSET_URL + '/css/app.css'。所以：
-
ASSET_URL必须是根域名，如https://cdn.example.com，不能带子路径 - 你上传到 CDN 的文件结构，必须和
public/下完全一致：即public/css/app.css→ CDN 根目录下/css/app.css - 如果 CDN 只允许上传到
/static/子目录，那不能靠改ASSET_URL解决，得重写asset()辅助函数，或在 Blade 中硬编码前缀
Debugbar 的 CDN 加载要单独处理
Laravel Debugbar 默认从应用服务器加载自身 CSS/JS，高并发时会成为瓶颈。它不走 ASSET_URL，而是读 DEBUGBAR_ROUTE_PREFIX：
- 在
.env中设置DEBUGBAR_ROUTE_PREFIX=https://cdn.example.com/laravel-debugbar - 确保 CDN 上对应路径存在完整资源，比如
/laravel-debugbar/debugbar.js - 别漏掉
config/debugbar.php中的route_prefix是否仍被硬编码覆盖 - 开发环境建议保留本地加载，生产环境再切 CDN，避免调试时资源加载失败却无报错
CDN 配置本身不复杂，真正卡住人的永远是路径拼接逻辑和部署一致性——ASSET_URL 写错一个字符、public 目录少同步一个子文件夹、config:cache 没清，都会让资源 404 或回源，白配。
