Laravel改public为public_html后npm run dev建目录报500错误

核心故障原因 #

两个独立问题叠加导致异常：

• Laravel Mix 公共路径配置使用了已废弃的属性写法，构建流程无法识别自定义输出路径，自动 fallback 到默认的public目录生成资源与mix-manifest.json文件
• 多处重复绑定path.public，框架不同加载阶段的配置会互相覆盖，路径解析逻辑冲突直接触发500错误

修复步骤 #

1. 修正Laravel Mix构建配置 #

删除webpack.mix.js中无效的mix.config.publicPath配置，改用官方提供的setPublicPath方法设置输出根目录，资源输出路径不需要重复写public_html前缀，修正后代码如下：

const mix = require('laravel-mix');

// 必须调用官方API设置公共输出根路径
mix.setPublicPath('public_html');

mix.js('resources/assets/js/app.js', 'js')
   .sass('resources/assets/sass/app.scss', 'css');

修改完成后先删除项目根目录下自动生成的public文件夹，再执行npm run dev，此时构建资源和mix-manifest.json会正确生成到public_html目录下，不会再自动新建public目录。

2. 清理重复的公共路径绑定 #

你在AppServiceProvider、index.php、bootstrap/app.php三个位置重复绑定了path.public，会因为加载顺序问题出现配置覆盖，只需要保留一处绑定即可，推荐放在加载优先级最高的bootstrap/app.php中：

• 删除app/Providers/AppServiceProvider.php中添加的path.public绑定代码
• 删除public_html/index.php入口文件中添加的path.public绑定代码
• 仅在bootstrap/app.php中保留绑定代码，注意代码要放在$app = new Illuminate\Foundation\Application(...)实例化代码之后、返回$app之前：

$app->bind('path.public', function() {
    return base_path('public_html');
});

3. 修正文件系统配置误区 #

你修改的config/filesystems.php中public磁盘配置，对应的是Laravel存储服务的本地文件路径，和框架公共访问目录不是同一个概念，不需要修改为public_html，改回默认配置即可：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

如果需要对外访问storage目录下的上传文件，执行php artisan storage:link命令，会自动在public_html目录下生成指向storage/app/public的软链，不需要手动修改磁盘根路径。

4. 清理缓存验证修复结果 #

完成以上修改后，在项目根目录依次执行以下命令清理框架缓存：

php artisan config:clear
php artisan route:clear
php artisan cache:clear

同时确认public_html目录权限为Web服务运行用户可读写（目录权限推荐设为755，文件权限推荐设为644），再访问站点即可恢复正常。

补充说明：如果使用Laravel 9及以上版本默认自带的Vite作为构建工具，只需要在vite.config.js中配置publicDir: 'public_html'即可，其余路径绑定逻辑和上述步骤一致。

内容的提问来源于stack exchange，提问作者Younes Barez